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Preface 


This manual explains the facilities and operating procedures for the SH series C compiler. Please 
read this manual and the related manuals listed below before using the C compiler to fully 
understand the system. The C compiler translates source programs written in C into relocatable 
object programs or assembly source programs for Hitachi superH RISC engine family 
microcomputers (SHI, SH2, SH3, and SH3E). 


Features of this compiler system are as follows: 


l. 
Ze 


4. 


generates an object program that can be written to ROM to be installed in a user system. 


supports an optimization option that increases execution speed of object programs or 
minimizes program size. 


. supports a debugging-information output function for a C source level debugging or C source 


analysis using a debugger . 


selects an assembly source program or relocatable object program and outputs it. 


This manual consists of four parts and appendixes. The information contained in each part is 
summarized below. 


l. 


PART I OVERVIEW AND OPERATIONS 
The overview sections cover C compiler functions and developing procedures. 


The operation sections cover how to invoke the compiler, how to specify optional functions, 
and how to interprete listings created by the C compiler. 


. PART IT C PROGRAMMING 


This part explains the limitations of the C compiler and the special factors in object program 
execution which should be considered when creating a program. 


PART IIT SYSTEM INSTALLATION 


This part explains the object program being written in ROM and memory allocation when 
installing an object program generated by the C compiler on a system. In addition, 
specifications of the low-level interface routine must be made by the user when using C 
language standard I/O library and memory management library. 


PART IV ERROR MESSAGES 


This part explains the error messages corresponding to compilation errors and the standard 
library error messages corresponding to run time errors. 


This manual describes the SH C compiler that operates on UNIX*', or MS-DOS ** that runs 
(operates) on the IBM-PC*? and PC compatibles. In this manual, compilers functioning on a 
UNIX system are referred to as UNIX version and compilers functioning on an MS-DOS system 
are referred to as PC systems. 


Notes on Symbols: The following symbols are used in this manual. 


Symbols Used in This Manual 


Symbol Explanation 
<> Indicates an item to be specified. 
[ ] Indicates an item that can be omitted. 


Indicates that the preceding item can be repeated. 
A Indicates one or more blanks. 
(RET) Indicates the carriage return key (return key). 
| Indicates that one of the items must be selected. 


(CNTL) Indicates that the control key should be held down while 
pressing the key that follows. 


Notes: 1. UNIX is a registered trademark in the United States and other countnies, licensed 
exclusively through X/Open Company Limited. 


2. MS-DOS is an operating system administrated by Microsoft Corporation. 
3. IBM PC is a registered trademark of International Business Machines Corporation. 


Related Manuals: Refer to the following manuals together with the SH Series C Compiler 
when creating a program using the C compiler. 


SH Series Cross Assembler User’s Manual 

SH Series Simulator/Debugger User’s Manual 
Integrated Manager User’s Manual 

H Series Linkage Editor User’s Manual 

H Series Librarian User’s Manual 

E7000 SH7032, SH7034 Emulator User’s Manual 
E7000 SH7604 Emulator User’s Manual 

E7000 SH7708 Emulator User’s Manual 

Refer to the following manuals for details on the SH instruction execution: 
SH7000 Series Programming Manual 
SH7000/SH7600 Series Programming Manual 


SH7700 Series Programming Manual 
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PART I 
OVERVIEW AND OPERATIONS 


Section 1 Overview 


The SH series C compiler converts source programs written in C to SH series relocatable object 
programs or assembly source programs. 


The C compiler supports the SH1, SH2, SH3, and SH3E microcomputers (collectively referred to 
as SH). 


Figure 1.1 shows C compiler functions. 


SH series SH relocatable 
C compiler object program 


C source 
program 


SH assembly source 
program 





Figure 1.1 C Compiler Functions 


A standard library file (a group of C language level functions that is used in C language program 
as standard) is also provided in addition to the C compiler. 
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Section 2 Developing Procedures 


Figure 1.2 shows the relationship between the C compiler package and other software for program 
development. The C compiler package indudes the software enclosed by the dotted line. 


User 


inciide SH series Standard 


C compiler include 
file 


User 
assembly 
source 


Assembly 
source 
program 


SH series 
= cross assembler 
nO 


Relo- 
catable 

object 
program 


Standard 
library 
file 


Routine #  H series 
created Alinkage edit 
Oo: ox 


ELT xB 
Oe Pes ¥ LRG EES: | 
IBGE: BEE : SORES? 


load 
module 


Target system 


Notes: 

1. Assembly source programs are output depending on option specification. 

2. The standard include file defines C library functions and their macro names in order to use C library functions. 

3. Debug information can also be added depending on option specification. 

4. A function group, consisting of C library functions and run time routines, is used as standard in the C program. 
(Refer to section 2.1, Static Area Allocation, in part II, SYSTEM INSTALLATION.) 





Figure 1.2. Relationship between the C Compiler and Other Software 


HITACHI 5 


6 HITACHI 


Section 3 C Compiler Execution 


This section explains how to invoke the C compiler, specify C compiler options, and interpret C 
compiler listings. 


3.1 How to Invoke the C Compiler 


The format for the command line used to invoke the C compiler is as follows. 





The general operations of the C compiler are described below. 


3.1.1 Compiling Programs 


shcAtest.c (RET) 


The C source program test.c is compiled. 


3.1.2 Displaying Command Line Format and Compiler Options 


The command line format and the list of the compiler options are displayed on the screen. 
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3.1.3 C Compiler Options 


Insert minus (—) before options (debug, listfile, and show). Slash (/) can also be inserted in 
place of minus (—) for PC. When multiple options are specified, separate them with a space (A). 
The following shows the options for UNIX and PC. Also when multiple suboptions are specified, 
separate them with a comma (,). 


shcA-debugA-listfileA-show=noobject,expansionAtest.c (RET) 


In PC, when multiple suboptions are specified, they can be enclosed in parentheses (( )). 


shcA/debugA/listfileA/show= (noobject, expansion) Atest.c(RET) 


3.1.4 Compiling Multiple C Programs 
Several C source programs can be compiled by a single command. 


Example 1: Specifying multiple programs 


shcAtestl1.cAtest2.c (RET) 


Example 2: Specifying options for all C source programs 


shcA-listfileAtest1.cAtest2.c (RET) 


The listfile option is valid for both testl.c and test2.c. 


Example 3: Specifying options for particular C source programs 


shcAtestl.cAtest2.cA-listfile (RET) 


The listfile option is valid for only test2.c. Options specified for particular C source programs 
have priority over those specified for all C source programs. 
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3.2 Naming Files 


A standard file extension is automatically added to the name of a compiled file when omitted. The 
standard file extensions used by the C compiler and related software are shown in table 1.1. For 
details on naming files, refer to the user's manual of the host computer because naming rules vary 
according to each host computer. 


Table 1.1 Standard File Extensions Used by the C Compiler 


File Extension Description 

Cc Source program file written in C 
h Include file 

lis, Ist Listing file* 

ob} Relocatable object program file 
SIC Assembly source program file 
lib Library file 

abs Absolute load module file 

rel Relocatable load module file 
map Linkage map listing file 


Note: The listing file extension is lis on UNIX systems and Ist on PC systems. 
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3.3 Compiler Options 


Table 1.2 shows C compiler option formats, abbreviations, and defaults. Characters underlined 
indicate the minimum valid abbreviation. Bold characters indicate default assumptions. 


Table 1.2 C Compiler Options 


Item 
CPU type 


Optimization 


Optimization 
select 


Debugging 
information 


Listings and 
formats 
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Format 
Cpu = 


optimize = 


speed 


nospeed 


size 


debug 
nodebug 
show= 


Default: 
w = 132, 
| = 66 


Suboption 
shi | 

sh2 | 

sh3 | 
sh3e 

0 | 


source | nosource | 


object | noobject | 
statistics | nostatistics | 





include | noinclude | 
expansion | noexpansion | 


width = <numeric value> | 


length = <numeric value> 


Specification 

SH1 object is generated. 
SH2 object is generated. 
SHS object is generated. 
SHSE object is generated. 


Object without optimization 
is output. 


Object with optimization is 
output. 


Optimization in both speed 
and size. 


Optimization in balance 
between execution speed 
and execution size is 
selected. 


Optimization in program 
size is selected. 


Output 
No output 
Source list yes/no 
Object list yes/no 


Statistics information 
yes/no 


List after include expansion 
yes/no 


List after macro expansion 
yes/no | 


Maximum characters per 
line: 

0, 80 to 132 

Maximum lines per page: 
0, 40 to 255 


Table 1.2 C Compiler Options (cont) 


Item 
Listing file 


Object file 


Object program 
format 


Macro name 


Include file 


Section name 


Help message 


Position 
independent 
code 


Area of string 
literal to be 
output 


Format Suboption 
listfile [ = <list file name>] 
nolistfile 


objectfile = <object file name> 


code = machinecode | 
asmcode 

define = <macro name> = <name> _ | 
<Macro name> = <constant> | 
<macro name> 

include = <path name> 

section = program = <section name> | 
const = <section name> | 
data = <section name> _ | 
bss =<section name> 

Default: 

p=P, c=C, 

d=D, b=B 

help 

pic = Oo | 
1 

String = const | 
data 


Specification 
Output 





Program in machine 
language is output. 


Assembly source program 
is output. 


<name> is defined as 
<macro name>. 


<constant> is defined as 
<macro name>. 


<macro name> is assumed 
to be defined. 


Include file destination path 
name is specified (multi- 
specification is possible). 


Program area section name 
is specified. 


Constant area section 
name is specified. 


Initialized data area section 
name is specified. 


Non-initialized data area 
section name is specified. 


Output 


Position independent code 
is not generated. 


Position independent code 
is generated. 


String literal is output to 
constant section (C). 


String literal is output to 
initialized data section (D). 
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Table 1.2 C Compiler Options (cont) 


Item 
Comment nesting 


Japanese code 
select in string 
literals 


Subcommand file 
select 


Division 
operation 


Memory bit order 


Inline expansion 
specification 


Default header 
file 


MACH and MACL 
registers — 
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Format 
comment = 


subcommand = 


ivision = 


noginline 
preinclude = 


macsave = 


Suboption 
nest | 


nonest 


<file name> 


cpus! 


peripheral | 
nomask 
big | 


little 


<numeric value> 


<file name> 


Specification 


Permits comment (/* */) 
nesting. 


Does not permit comment 
(/* */) nesting. 


Selects euc code. 
Selects sjis code. 


Includes command option 
from a file specified by 
<file name>. 


Uses cpu's division 
instruction. 


Uses a divider (with 
masking interruption). 


Uses a divider (without 
masking interruption). 


Specifies maximum big 
endian. 


Specifies little endian. 


Specifies inline 
expansion. 


Specifies the maximum 
size of a function to 
expand where the function 
is called. 


Includes contents of a 
specified file at the 
beginning of compilation 
units. 


Does not guarantee 
contents of MACH and 
MACL registers at function 
call. 


Guarantees contents of 
MACH and MACL registers 
at function call. 


Table 1.2 C Compiler Options (cont) 


Item 


Information 
message output 


Label 16-byte 
alignment 


Double type to 
single precision 


Japanese 
character 
conversion 


ABS16 
declaration 


Loop unroll 


Inline expansion 


EXTS and EXTU 
creation at data 
return 


Format 
message 


nomessage 


align16 


noaligni6 


double = 


Qutcode = 


abs16 = 


loop 
noloop 


nestinline = 


rtnext 


nortnext 


Suboption 


float 


euc | 


sjis 
run | 


[2 


<numeric value> 


Specification 


Outputs information 
message. 


Does not output 
information message. 


Labels placed immediately 
after an unconditional 
branch instruction other 
than a subroutine call in a 
program section must be 
aligned in 16 bytes. 


Does not place labels 
aligned in 16 bytes. 


Treats double type (double 
precision floating point 
number) as float type 
(single precision floating 
point number) as object. 


Selects euc code. 


Selects sjis code. 


Assumes all execution 
routines to have been 
declared with #pragma 
abs16. 


Generates all label 
addresses in 16 bits. 


Optimizes loop unrolling. 


Does not optimize loop 
unrolling. 


Specifies the number of 
times to expand nested 
inline functions. 


Creates a sign-extension 
or zero-extension 
instruction for the upper 
bytes when returning a 
value to a program by the 
return statement. 


Does not create a sign- 
extension or zero- 
extension instruction. 
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-cpu = shl | sh2 | sh3 | sh3e 
This option specifies a target CPU. A library to be linked differs according to a 
CPU. For details, refer to section 3.5, Correspondence to Standard Libraries in 
part I OVERVIEW AND OPERATIONS. 

—optimize =01/1 
This option specifies compiler optimization. 
optimize = 0 disables compiler optimization. 


optimize = | enables compiler optimization. 


—speed, —nospeed 


This option specifies speed optimization. When a speed option ts specified, 
program is executed faster but program size may increase. When nospeed is 
specified but size option is not specified, optimization is performed in program 
execution speed and program size. 


This option specifies optimization in object size. 
—debug, —nodebu g 


This option specifies whether or not to output debugging information which is 
necessary for C source level debugging. 


—show = source | nosource | object | noobject | statistics | nostatistics | include | noinclude 


| expansion | noexpansion | width = <numeric value> | length = <numeric value> 





This option specifies the output format of a list file. This option is valid when a 
listfile option is specified. 
show = width = 0 One line ends at a carriage code. 
show =length=0Q The maximum number of lines is not specified; 
therefore, pagination is not performed. 


—listfile [=<listfile name>], —nolistfile 
This option specifies whether a list file is output. When a file name is not 
specified, a file that has the same name as the source file with a standard 
extension lis/Ist is generated. 





—objectfile = <objectfile name> 
This option specifies an object file name to be output. 
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—code = machinecode | asmcode 
This option specifies whether the compiler outputs an object file in a machine 
language or an assembler source file. 


—define = <macro name> = <name> | <macro name> = <constant> | <macro name> 
This option enables a macro definition at the beginning of a source program. 
Table 1.3, describes macro names, names, and constants which can be specified 
using this option. 


Table 1.3 Macro Names, Names, and Constants Specified by the Define Option 





Item Description 

Macro name A string literal beginning with a letter or an underscore followed by zero or 
more letters, underscores, and numbers. 

Name A string literal beginning with a letter or an underscore followed by zero or 


more letters, underscores, and numbers. 


Constant Decimal constant: A string literal of one or more numbers (0 to 9), 
or a string literal of one or more numbers 
followed by a period (.) followed by zero or 
more numbers. 

Octal constant: A string literal that begins with a zero followed 
by one or more numbers (0 to 7). 

Hexadecimal constant: A string literal that begins with a zero followed 
by an x, then followed by one or more numbers 
or alphabetical letters (A to F). 





—include = <path name> 
This option specifies a directory where an include file is searched for. For details 
on how to search, refer to Appendix A.1.13, Preproccessor. 


—section = | program = <section name> | const = <section name> | data = <section name> | bss = 
< section name > 
This option changes section names in object programs. Section names when 
this option 1s omitted are program area section P, constant area section C, 
initialized data area section D, and non-initialized data area section B. 


—help 
This option displays a list of compiler options. Once this option is specified, 
the other option(s) will be disabled. 
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—pic=011 


When pic = | is specified, a program section after linking can be allocated to any 
address and executed. A data section can only be allocated to an address specified 
at linking. When using this option as a position independent code, a function 
address cannot be specified as an initial value. Note that if cpu = SH1 is 
specified, pic = 1 is ignored. A library to be linked varies according to 
the cpu, pic, endian, or double option. For details, refer to section 3.5, 
Correspondence to Standard Libraries in part I, OVERVIEW AND 
OPERATIONS. 


Example 
extern int f (); 


int (*fp)() = f; <— Cannot be specified 


—string = const | data 


When string = const is specified, string literals are output to constant area section 
(default is C). When string = data is specified, string literals are output to 
initialized data area section (default is D). 


—comment = nest | nonest 





—SjIS 
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This option specifies whether or not to permit comment /* */ nesting. 


Example 
/* comment 
int. ‘az 7% nestl is nset2 : : 
ay 
When comment = nest is specified, an underlined section is treated as a nested 


comment and the outermost comment is enforced. 


When comment = nonest is specified, a comment is treated to end by nest2*/. 
Therefore, a section after nest2*/ is treated as an error. 


This option selects euc for the Japanese code for string literals in C program. 
When this option is omitted, euc or sjis is selected according to the host 
computer. For details, refer to section 3.5, Japanese Description in String 
Literals in part II, C Programming. 


This option selects sjis for the Japanese code for string literals in C program. 
When this option is omitted, euc or sjis is selected according to the host 
computer. For details, refer to section 3.5, Japanese Description in String 
Literals in part II, C Programming. 


—subcommand = <file name> 


This option assumes contents of a specified file name as an option. This option 
can be specified in a command line more than once. In a subcommand file, an 
parameters must be delimited by a space, a carriage return, or a tab. Contents in 
a subcommand file will be expanded to an area specified by a subcommand in a 
command line parameter. A subcommand option cannot be specified in a 
subcommand file. 


Example: The following examples are the same as shc —debug —cpu=sh2 test.c. 


Command line 
she —sub=test.sub test.c 


Contents of test.sub 
—debug 
—cpu=sh2 


—division = cpu | peripheral | nomask 
This option selects an execution routine for an integer division in a C source 
program. This option can be combined with a suboption in the cpu option. 
However, only the SH2 can execute an object program that specifies peripheral or 
nonmask as suboption. 


I 


cpu: specifies an execution routine which uses the DIV1 
instruction 


2. peripheral: specifies an execution routine using a divider 


ce 


(15 is set to interrupt mask level) 


nomask: specifies an execution routine using a divider 
(no change in interrupt mask level) 


Note the following before specifying a peripheral or nomask option. 


L. 
2. 


Zero division is not checked or errno is not set. 

If nomask is specified and an interrupt occurs during operation of a 
divider and the divider is used in an interrupt routine, the correct 
operation Is not guaranteed. 


. An overflow interrupt is not supported. 


4. Results after operation such as zero division or overflow depend on the 


divider specifications. Some of them may be different from those when 
a cpu suboption is specified. 
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-endian = big | little 


This option can be combined with a suboption in a cpu option. However, only 
the SH3 or SH3E can execute an object program for little endian. The library to 
be linked depends on endian, cpu, pic, and double options. For details, refer to 
section 3.5, Correspondence to Standard Libraries in part IL OVERVIEW AND 
OPERATIONS. 


—inline, —inline = <numeric value>, —noinline 





This option specifies whether to expand a function automatically at the statement 
where the function 1s called. The value specified in suboption <numeric value> 
indicates the maximum number of nodes of a function (the total number of 
characters of operators and variables excluding the declaration field) to expand 
where the function is called. The default of speed option specification is inline = 
20. The default when nospeed, size, or optimize = O option is specified noinline. 


—preinclude = <file name> 


—macsave =Q|1 


This option includes file contents at the beginning of compilation units. 


This option specifies whether contents of the MACH or MACL registers are 
guaranteed before and after a function call. 

macsave = 0 does not guarantee the contents of the MACH or MACL registers 
before and after a function call. macsave = 1 guarantees the contents of MACH 
and MACL registers before and after a function call. A function that 1s compiled 
using macsave = 1 cannot call a function that is compiled using macsave = 0. 
However, the opposite is possible. 


—message, nhomessage 


This option specifies information message output. nomessage option does not 
output information message. 


—alignl6, noalign16 





—double = float 
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This option aligns all labels placed immediately after an unconditional branch 
instruction other than subroutine calls in a program section in 16 bytes. 
noalign16 option does not place labels aligned in 16 bytes. 


This option treats double type declaration/cast (double precision floating point 
number) as float type declaration/cast (single precision floating point number) 
before generating object. 


—outcode = euc | sjis 
This option selects euc for the Japanese character code when outcode = euc is 
specified, and sjis when outcode = sjis 1s specified. 


~abs 16 = run | all 
This option assumes all execution routines to have been declared with #pragma 
abs16 when abs16 = run is specified, and generates all label addresses in 16 bits 
when abs 16 = all is specified. 


~loop, -noloop 
This option specifies whether to optimize loop unrolling. 
The loop option performs loop unrolling. The noloop option does not perform 
loop unrolling. 


—nestinline = <numeric value> 
This option specifies the number of times to expand the inline function. Up to 
16 times can be specified. When this option is not specified (default), the inline 
function is expanded once (nestinline=1). 


—Itnext, —-nortmext 
This option performs sign extension or zero extension after setting a value in 
RO, which is the place to set the return value, in a return statement of a function 
that returns a (unsigned) char type or (unsigned) short type (see section 2.2.3 in 
part II, CPROGRAMMING) to a program. This enables type conversion for a 
return value before the actual value is returned to a program. If a prototype is 
declared at the caller, this option is not required. The nortnext option does not 
perform sign extension or zero extension. 
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3.4 Option Combinations 


If a pair of conflicting options or suboptions are specified for a file, only one of them is considered 
valid. Table 1.4 shows such option combinations. 


Table 1.4 Option Combinations 








Valid Option Invalid Option 
nolist show 
code = asmcode”* debug* 


show = object 


help All other options 
cpu = shi pic=1 
optimize = 0 loop 


Note: When debug option is specified during assembly source output, a .LINE directive is 
embedded in the output code. A .LINE directive gives C language source line information to 
a debugger. After that, C language source lines are displayed for debugging. However, C 
language level debugging is not performed for variable values. 
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or) Correspondence to Standard Libraries 


There are 22 types of standard library combinations. Link a library listed in table 1.5 according to 
the combination of a cpu, pic, endian, or double option. 


shclib.lib (for SH1) 

shenpic.lib (for SH2, not for position independent code) 

shcpic.lib (for SH2, for position independent code) 

she3npb.lib (for SH3, not for position independent code, big endian) 

shc3pb.lib (for SH3, for position independent code, big endian) 

shce3npl.lib (for SH3, not for position independent code, little endian) 

shce3pl.lib (for SH3, for position independent code, little endian) 

shcenpb.lib (for SH3E, not for position independent code, big endian) 

shcepb.lib (for SH3E, for position independent code, big endian) 

shcenpl.lib (for SH3E, for position independent code, little endian) 

shcepl.lib (for SH3E, for position independent code, little endian) 

shclibf.lib (for SH1, double = float option specification) 

shenpicf.lib (for SH2, not for position independent code, double = float option specification) 
shepicf.lib (for SH2, for position independent code, double = float option specification) 
shc3npbf.lib (for SH3, not for position independent code, big endian, double = float option 
specification) 

she3pbf.lib (for SH3, for position independent code, big endian, double = float option 
specification) 

shc3nplf.lib (for SH3, not for position independent code, little endian, double = float option 
specification) 

she3plf.lib (for SH3, for position independent code, little endian, double = float option 
specification) 

shcenpbf.lib (for SH3E, not for position independent code, big endian, double = float option 
specification) 

shcepbf.lib (for SH3E, for position independent code, big endian, double = float option 
specification) 

shcenplf.lib (for SH3E, not for position independent code, little endian, double = float option 
specification) 

shceplf.lib (for SH3E, for position independent code, little endian, double = float option 
specification) 
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Table 1.5 Correspondence between Standard Libraries and Compile Options 


double specification 
endian specification 


pic specification 


cpu = sh1 
cpu = sh2 
cpu = sh3 
cpu = sh3e 


double specification 
endian specification 


pic specification 


cpu = shi 
cpu = sh2 
cpu = sh3 
cpu = sh3e 
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None 
endian = big endian = little 
pic = 0 pic = 1 pic = 0 pic = 1 
shclib.lib — — — 
shenpic.lib shcpic.lib — == 
she3npb.lib shce3pb.lib shc3npl.lib she3pl.lib 
shcenpb.lib shcepb.lib shcenpl.lib shcepl.lib 
double = float 
endian = big endian = little 
pic = 0 pic = 1 pic = 0 pic = 1 
shclibf.lib — — — 
shenpicf.lib shcpicf.lib — — 
shc3npbf.lib shc3pbf.lib shcS3npif.lib shc3plif.lib 
shcenpbf.lib shcepbf.lib shcenplf.lib shceplif.lib 


3.6 C Compiler Listings 


This section describes C compiler listings and their formats. 


3.6.1 Structure of C Compiler Listings 
Table 1.6 shows the structure and contents of C compiler listings. 


Table 1.6 Structure and Contents of C Compiler Listings 


Option Specification 


List Structure Contents Method*' Default 

Source listing Listing consists of show=[no]source No output 
source programs 
Source program listing after (show=[no]linclude)*? No output 
include file and macro expansion (show=[no]Jexpansion) 

Object listing Machine language generated by show=([noJobject Output 
the C compiler and assembly 
code 

Statistics Total number of errors, number show=[no]statistics Output 


of source program lines, size of 
each section (byte), and number 


of symbols 
Command line File names and options specified — Output 
specification in the command line 


Notes: 1. All options are valid when listfile is specified. 
2. The option enclosed in parentheses is only valid when show = source is specified. 
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3.6.2 Source Listing 


The source listing can be output in two ways. When show = noinclude, noexpansion is 
specified, the unpreprocessed source program is output. When show = include, expansion is 
specified, the preprocessed source program is output. Figures |.3 and 1.4 show examples of these 
output formats. Bold characters in figure 1.4 show the differences. 


kek eKEKEKEEH SOURCE LISTING ttt 8 # ke Ree 
FILE NAME: m0260.c 


File Line Q----+----1]----+----2----+----3----+----4----+----5--- 
m0260. si #include “header.h" 
m0260. 
m0260. 
m0260. 
m0260. 
m0260. 
m0260. 
m0260. 
m0260. 
m0260. 
m0260.c 11 
mo260.c 12 return j;/* continuel23456789012345678901234567 

(2) (3) +2345678901234567890 */ 

(7) 

m0260.c 13 } 


int sum2 (void) 


{ int j; 


#ifdef SMALL 
j=SML_INT; 


#else 


Oo Oo wv Hn Wl & W NY 


j=LRG_INT; 
#endif 


~ 
oO 


Cc 
c 
c 
Cc 
Cc 
c 
Cc 
Cc 
c 
c 
Cc 





Figure 1.3 Source Listing Output for show = noinclude, noexpansion 
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KEKE KKKKE KH SOURCE LISTING Ree KAKKRERK 


FILE NAME: m0260.c 


Seq File Line Q----+----]----+----2----+----3----+----4----+----5--- 
1 m0260.c nf #include “header.h" 
2 header.h 1 #define SML_INT af 
3 header .h 2 #define LRG_INT 100 (4) 
4 m0260.c 2 
5 m0260.c 3 int sum2 (void) 
6 m0260.c 4 { int’ 3; 
7 m0260.c 5 
8 m0260.c 6 #ifdef SMALL 
9 m0260.c 7x j=SML_INT; 
10 m0260.c 8 (5S) #else 
11 m0260.c 9 = j=100; 
12 m0260.c 10 (6) #endif 
13) =~m0260.c tye 
14 mo26e0,c 12 return j;/* continuel23456789012345678901234567 
(1) (2) (3) +2345678901234564890 */ 
(7) 
15.  m0260.c 13 } 


Figure 1.4 Source Listing Output for show = include, expansion 


Description: 

(1) Listing line number 

(2) Source program file name or include file name 

(3) Line number in source program or include file 

(4) Source program lines resulting from an include file expansion when show = include is 
specified. — 


(5) Source program lines that are not to be compiled due to conditional compile directives such as 
#ifdef and #elif being marked with an X when show = expansion is specified. 


(6) Source program lines containing a macro expansion #define directives being marked with an 
E when show = expansion is specified. 


(7) If a source program line is longer than the maximum listing line, the continuation symbol (+) 
is used to indicate that the source program line is extended over two or more listing lines. 
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3.6.3 Object Listing 


The object listing can be output in two ways. When show = source, object is specified, the 
source program is output. When show = nosource, object is specified, the source program is 
not output. 

Figures 1.5 and 1.6 show examples of these listings. 


week eeREAEE OBJECT LISTING *tteeeweereas 
FILE NAME: m0251.c 


SCT QFFSET CODE C LABEL INSTRUCTICN OPERAND 

(1) (2) (3) (4) 
m0251.c extern int multipli(int); 
m0251.c 
m0251.c int multipli(int x) 

P 00000000 ;function: multipli 

; frame size=16 (7) 

;used runtime library name: 


_multipli: 


;__Imuali (8) 


00000000 4F22 STS.L PR,R15 

00000002 7FF4 ADD #-12,R15 

00000004 1F42 MOV.L R4,@(8,R15) 
m0251. 


mO251. 
m0251. 
m0251. 
m0251. 
00000006 E201 
00000008 2F22 
m0251.c 
OOOO000A’~ = E301 
0000000C 1F31 
QOOOO00E # £AOdO9 
00000010 0009 
00000012 
m0251.c 
00000012 50F1 
00000014 61F2 
00000016 D30A 
00000018 430B 


Figure 1.5 
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int i; 
int j; 


j=1; 

MOV #1,R2 
MOV.L R2,@R15 
for (i=1;i<=x; i++) { 
MOV #1,R3 


MOV .L R3,@(4,R15) 


BRA L213 
NOP 


j*=i; 


@(4,R15),R0 


@R15,R1 
L216+2,R3 
@R3 





Object Listing Output for show = source, object 


KKK KKKE HK OBJECT LISTING eteeeekeke eae ee 


FILE NAME: m0251l.c 








SCT QFFSET CODE C LABEL INSTRUCTION OPERAND COMMENT 
(1) (2) (3) (4) (5) 
P :File mQ25l.c¢ Line 3 :block 
00000000 _Multipli: (6) ;function: multipli 
; frame size=16 (7) 
;used runtime library name; 
ere SUG (8) 
00000000 4F22 STS.L PR, @R15 
00000002 7FF4 ADD #-12,R15 
00000004 1F42 MOV .L R4,@(8,R15) 
;File m0251l.c ,Line 4 ; block 
;File m025l.c ,Line 8 ;expression statement 
00000006 E201 MOV #1,R2 
00000008 2F22 MOV.L R2,@R15 
;File m0251l.c ,Line 9 ; for 
OOOO0O00A £301 MOV #1,R3 
0000000C 1F31 MOV.L R3,@(4,R15) 
OOOOO0O00E AOOS BRA L213 
00000010 0009 NOP 
00000012 L214: 
;File m025l.c ,Line 9 ; block 
;File m025l.c ,Line 10 ;expression statement 
00000012 50F1 MOV.L @(4,R15),R0 
00000014 61F2 MOV .L @R15,R1 
00000016 D30A MOV.L L216+2,R3 ;_ —muli 
00000018 430B JSR @R3 


Figure 1.6 Object Listing Output for show = nosource, object 


Description: 
(1) Section attribute (P, C, D, and B) of each section 


(2) Offset address relative to the beginning of each section 
(3) Contents of the offset address of each section 
(4) Assembly code corresponding to machine language 


(5) Comments corresponding to the program (only output when not optimized; however, labels are 
always output) 


(6) Line information of the program (only output when not optimized) 
(7) Stack frame size in bytes (always output) 
(8) Routine name that is being executed 
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3.6.4 Statistics Information 


Figure 1.7 shows an example of statistics information. 


#*e*eeHHe STATISTICS INFORMATION *****#** 


tk kkk eK EK PRROR INFORMATION *****#* ee 
NUMBER OF ERRORS: 

NUMBER OF WARNINGS: 

NUMBER OF INFORMATIONS : 


** ee eee* SOURCE LINE INFORMATION ******** 


COMPILED SOURCE LINE: 


«x 4ee44% SECTION SIZE INFORMATION ******4# 

PROGRAM SECTION (P) : 0x000044 Byte(s) 
CONSTANT § SECTION(C) : 0x000000 Byte(s) 
DATA SECTION (D) : 0x000000 Byte(s) 


BSS SECTION (B) : 0x000000 Byte(s) 


TOTAL PROGRAM SIZE: 0x000044 Byte(s) 


wk kkkkkkke LABEL INFORMATION kKkekkkkkkkne 


NUMBER OF EXTERNAL REFERENCE SYMBOLS: 1 
NUMBER OF EXTERNAL DEFINITION SYMBOLS: 1 
NUMBER OF INTERNAL/EXTERNAL SYMBOLS: 6 





Figure 1.7 Statistics Information 
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Description: 
(1) Total number of messages by the level 


(2) Number of compiled lines from the source file 
(3) Size of each section and total size of sections 


(4) Number of external reference symbols, number of external definition symbols, and total 
number of internal and external labels 


Note: NUMBER OF INFORMATIONS in messages by the level ((1) above) is not output when 
message option is not specified. Section size information (3) and label information (4) are 
not output if an error-level error or a fatal-level error has occurred or when option 
noobject is specified. In addition, section size information (3) is output (indicated as 
‘1’’) or not output (indicated as “O”) according to its specification when option code = 
asmcode is specified. 


3.6.5 Command Line Specification 


The file names and options specified on the command line when the compiler is invoked are 
displayed. Figure 1.8 shows an example of command line specification information. 


*** COMMAND PARAMETER *** 


-listfile test.c 





Figure 1.8 Command Line Specification 
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3.7 C Compiler Environment Variables 


Environment variables to be used by the compiler are listed in table 1.7. 


Table 1.7 Environment Variables 


Environment 
Variable 


SHC_LIB 


SHC_INC 


SHC_TMP 


SHCPU 
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Explanation in Use 


Specifies a directory at which compiler load module and system include 
file exists. 


Specifies a directory at which a system include file exists. More than 
one directory can be specified by dividing directories using commas. A 
system include file is searched for at a directory specified using an 
include option specified directory, SHC_INC-specified directory, and 
system directory (SHC_LIB) in this order. 


Specifies a directory where the compiler generates a temporary file. 
This environment variable is required fora PC. For UNIX, a directory 
indicated in TMPDIR is specified when this environment variable is 
specified. If SHC_TMP or TMPDIR is not specified, a temporary file is 
generated in /usr/tmp. 


Specifies CPU type by compiler —cpu option using environment 
variables. The following is specified: 

SHCPU=SH1 (same as —cpu=sh1) 

SHCPU=SH2 (same as —cpu=sh2) 

SHCPU=SHDSP (same as —cpu=sh2) 

SHCPU=SH3 (same as —cpu=sh3) 

SHCPU=SH3E (same as —cpu=sh3e) 
An error-will occur if anything other than the above is specified. 
Specifying lower case characters will also generate an error. 
When the specification of CPU by SHCPU environment variable and 
~—cpu option differs, a waming message is displayed. —cpu option 
has priority to SHCPU specification. 


3.8 Implicit Declaration by Option 


Using -cpu, —pic, —endian, or —double option results in an implicit #define declaration. See 


the following. 


Table 1.8 Implicit Declaration 


Option 
—cpu = shi 
—cpu = sh2 
—cpu = sh3 
—cpu = sh3e 
—pic 


—endian = big 
—endian = little 
—double = float 


Implicit Declaration 
#define _SH1 (including default) 


#define _SH2 

#define _SH3 

#define _SH3E 

#define _PIC 

#define _BIG (including default) 
#define _LIT 

#define _FLT 


The following shows an specification example. 


Example: 
#ifdef _BIG 
#ifdef _SH1 
#tendif 
#endif 
#ifdef _SH2 
#tendif 
#ifdef _SH3 
#ifdef _BIG 
#tendif 
#ifdef _LIT 
#tendif 
#endif 


Valid when —cpu = shl -endian = big option is specified 
(Also valid when no option is specified for -cpu or —endian) 


Valid when —cpu = sh2 option 1s specified 


Valid when -cpu = sh3 -endian = big option is specificed 


Valid when —cpu = sh3 -endian = little option is specified 


Rules: 1. If no option is specified (default), #define _SH1 or #define _BIG 1s set. 
2. The implicit #define declaration is specified as #undef in the source file. 
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PART I 
C PROGRAMMING 


Section | Limits of the C Compiler 


Table 2.1 shows the limits on source programs that can be handled by the C compiler. Source 
programs must fall within these limits. To edit and compile efficiently, it is recommended to split 
the source program into smaller programs (approximately two ksteps) and compile them 


separately. 


Table 2.1 Limits of the C Compiler 


Classification 


Invoking the C 
compiler 


Source programs 


Preprocessing 


Declarations 


item 


Number of source programs that can be compiled at one 
time 


Total number of macro names that can be specified using 
the define option 


Length of file name (characters) 

Length of one line (characters) 

Number of source program lines in one file 

Number of source program lines that can be compiled 
Nesting levels of files in an #include directive 


Total number of macro names that can be specified ina 
#define directive 


Number of parameters that can be specified using a 
macro definition or a macro call operation 


Number of expansions of a macro name 


Nesting levels of #if, #ifdef, #ifndef, #else, or 
#elif directives 


Total number of operators and operands that can be 
specified in an #if or #elif directive 


Number of function definitions 
Number of internal labels*? 
Number of symbol table entries** 


Total number of pointers, arrays, and functions that 
qualify the basic type 


Array dimensions 


Limit 


None”! 


None 


128 
4096 
65535 
None 
30 


None 


63 


32 
32 


512 


912 
32767 
24576 
16 
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Table 2.1 Limits of the C Compiler (cont) 


Classification Item Limit 
Statements Nesting levels of compound statements 32 


Nesting levels of statement in a combination of repeat 32 
(while, do, and for) and select (if and switch) 


statements 
Number of goto labels that can be specified in one 511 
function 
Number of switch statements 256 
Nesting levels of switch statements 16 
Number of case labels 511 
Nesting levels of for statements 16 
Expressions Number of parameters that can be specified using a 63 
function definition or a function call operation 
Total number of operators and operands that can be About 500 
specified in one expression 
Standard library Number of files that can be opened at once in open 20 
function , 
Notes: 1. For PC, the number of command line that can be compiled at one time is limited to 127 
characters. 


2. An internal label is internally generated by the C compiler to indicate a static variable 
address, case label address, goto label address, or a branch destination address 
generated by if, switch, while, for, and do statements. 


3. The number of symbol table entries is determined by adding the following numbers: 
Number of external identifiers 
Number of internal identifiers for each function 
Number of string literals 
Number of initial values for structures and arrays in compound statements 
Number of compound statements 
Number of case labels 
Number of goto labels 
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Section 2 Executing a C Program 


This section covers object programs which are generated by the C compiler. In particular, this 
section explains the items necessary for the linkage of the C program with an assembly program, 
or when incorporating a program into an SH system. 


2.1 Structure of Object Programs: This section discusses the characteristics of memory 
areas used for C programs and standard library functions. 


2.2 Internal Data Representation: This section explains the internal representation of data 
used by aC program. This information is required when data is shared among C programs, 
hardware, and assembly programs. 


2.3 Linkage with Assembly Programs: This section explains the rules for variables and 
function names that can be mutually referenced by multiple object programs. This section also 
discusses how to use registers, and how to transfer parameters and return values when a C program 
calls a function. This information is required for C program functions calling assembly program 
routines or vice versa. 


Refer to respective hardware manuals for details on SH hardware. 
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2.1 Structure of Object Programs 


This section discusses the characteristics of memory areas used by a C program or standard library 
function in terms of the following items. 


1. Section 


Composed of memory areas which are allocated statically by the C compiler. Each section has 
a name and type. A section name can be changed by the compiler option section. 


2. Write Operation 

Indicates whether write operations are enabled or disabled at program execution. 
3. Initial Value 

Shows whether there is an initial value when program execution starts. 
4. Alignment 

Restricts addresses to which data is allocated. 


Table 2.2 shows the types and characteristics of those memory areas. 
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Table 2.2 Memory Area Types and Characteristics 


Memory 
Area 
Name 


Program 
area 


Constant 
area 


Initialized 
data area 


Non- 
initialized 
data area 


Stack area 


Heap area 


Section Section 


Name' 
Pr 


C 


Type 
code 


data 


data 


data 


Write 
Operation 
Disabled 
Disabled 


Enabled 


Enabled 


Enabled 


Enabled 


Initial 
Value 
Yes 
Yes 


Yes 


No 


No 


No 


Alignment 
4 bytes” 


4 bytes 
4 bytes 


4 bytes 


4 bytes 


Contents 


Stores machine 
codes. 


Stores const 
data. 


Stores initial 
value. 


Stores data 
whose initial 
values are not 
specified. 


Required for 
program 
execution. 
Refer to section 
2.2 Dynamic 
Area Allocation, 
in part Ill, 
SYSTEM 
INSTALLATION. 


Used by a 
library function 
(malloc, 
realloc, or 
calloc). Refer 
to section 2.2 
Dynamic Area 
Allocation, in 
part Ill SYSTEM 
INSTALLATION. 


Notes: 1. Section name shown is the default generated by the C compiler when a specific name is 
not specified by the compiler —section option. 


2. Becomes 16 bytes when —align16 option is specified. 
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Example: 
This program example shows the relationship between a C program and the sections 


generated by the C compiler. 


Program area main(){...} 
int a=1; 


char b; 
Constant area 


const int c=0; 
main() { se ates 
Initialized data area 


} 
Non-initialized data area 


file.c 


C program Area to be generated by the compiler and 
data to be stored in it. 
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2.2 Internal Data Representation 


This section explains the internal representation of C language data types. The internal data 
representation is determined according to the following four items: 


1. Size 
Shows the memory size necessary to store the data. 
2. Alignment 


Restricts the addresses to which data is allocated. There are three types of alignment; 1-byte 
alignment in which data can be allocated to any address, 2-byte alignment in which data is 
allocated to an even byte address, and 4-byte alignment in which data 1s allocated to an address 
indivisible by four. 


3. Data range 
Shows the range of scalar-type data. 
4. Data allocation example 


Shows how the elements of combined-type data are allocated. 
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Scalar-Type Data 


Table 2.3 shows the internal representation of scalar-type data used in C. 


Table 2.3 Internal Representation of Scalar-Type Data 


Data Type 


char (signed 


char) 


unsigned char 


short 


unsigned short 


int 


unsigned int 


long 


unsigned long 


enum 


float 
double 
long double 


Pointer 


Note: The size of double type is 4 bytes if -double=float option is specified. 
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Size 
(bytes) 


Alignment 
(bytes) 


1 


Rims; rms — 


4 


Sign 
Used 


Unused 
Used 
Unused 
Used 


Unused 


Used 


Unused 


Used 


Used 
Used 


Unused 


Data Range 


Minimum 
Value 


~27 (-128) 


0 
~2'5 (32768) 

0 

~2"' (2147483648) 


—2"' (-2147483648) 


-2"' (2147483648) 


0 


Maximum 
Value 


BF 41127) 


2° _ 1 (255) 
2'5 _ 1 (32767) 
2°6 _ 4 (65535) 
a'- 4 
(2147483647) 
27 — 4 
(4294967295) 
2-4 
(2147483647) 
2° — 4 
(4294967295) 
24 
(2147483647) 
+ co 


+ co 


27-4 
(4294967295) 


2.2.2 Combined-Type Data 


This part explains the internal representation of array, structure, and union data types. Table 2.4 
shows the internal data representation of combined-type data. 


Table 2.4 Internal Representation of Combined-Type Data 


Data Type Alignment 


(bytes) Size (bytes) Data Allocation Example 
Array Maximum array Number of array elements int a[10]; 
element alignment x element size Alignment: 4 bytes 
Size: 40 bytes 
Structure*' | Maximum structure _—_‘ Total size of members*' struct { 
member alignment int a, b; 


} 
Alignment: 4 bytes 
Size: 8 bytes 
Union Maximum union Maximum size of union { | 
member alignment member” int a,b; 
} 
Alignment: 4 bytes 
Size: 4 bytes 
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In the following notes, a rectangle indicates four bytes. 


Note 1: 
When allocating a member of a structure type, an empty area may be created between a 
member and the previous member to adjust the alignment of a data type of the member. 


struct { 
char a; 
int b;}z; 


Z 


When a structure has a four-byte alignment, and the last member ends at the first, second or 
third byte, the remaining bytes are included in a structure type area. 


struct { 
int a; 
char b;}x; 


| 


Note 2: 
When a union has a four-byte alignment, and the maximum value of the member size is not a 
multiple of four, the remaining bytes up to a multiple of four are included in the union type 
area. 


union { 
int a; 
char b [7];}w; 






w.b[O]w.b[1 Jw.b[2]w.b[3] 


w.b[4]w.b[5]w.b[6] A 


44 HITACHI 


2.2.3 Bit Fields 
A bit field is a member of a structure. This part explains how bit fields are allocated. 
Bit field members: Table 2.5 shows the specifications of bit field members. 


Table 2.5 Bit Field Member Specifications 


Item Specifications 
Type specifier allowed for bit fields char, unsigned char, short, unsigned short, 


int, unsigned int, long, and unsigned long 


How to treat a sign when data is extended A bit field with no sign (unsigned is specified for 
to the declared type”’ type): Zero extension” 


A bit field with a sign (unsigned is not specified for 
type): Sign extension* 


Notes: 1. To use a member of a bit field, data in the bit field is extended to the declared type. 
One-bit field data with a sign is interpreted as the sign, and can only indicate 0 and —1. 
To indicate 0 and 1, bit field data must be declared with unsigned. 


2. Zero extension: Zeros are written to the high-order bits to extend data. 


3. Sign extension: The most significant bit of a bit field is used as a sign and the sign is 
written to all higher-order bits to extend data. 
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Bit field allocation: Bit field members are allocated according to the following five rules: 


1. Bit field members are placed in an area beginning from the left, that is, the most significant 
bit. | 


Example: a5 0 
struct bl{ > eo 
, eryee nga 
int as2* 2 3 
LHe. -b23% 
}x; 


2. Consecutive bit field members having type specifier of the same size are placed in the same 
area as much as possible. 


Example: 54 ; 
struct bl { > faye? 
we aE 
long at2; Oe’ 3G 
unsigned int b:3; 
}y; 


3. Bit field members having type specifier with different sizes are allocated to the following areas. 


Example: 31 0 
struct bl 
Ln ass a a 
char b:4; 
ee eel 
4 


4. If the number of remaining bits in the area is less than the next bit field size, though type 
specifier indicate the same size, the remaining area is not used and the next bit field is allocated 
to the next area. 


Example: 31 24 16 
struct b2{ => Eva i vb 
char a:5; —— 4 
char b:4; 
}v; 
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5. Ifa bit field member with a bit field size of 0 is declared, the next member is allocated to the 
next area. 


Example: x a i; 
struct b2{ 
char a:5; = wa ea 
char :0; : > 
char’ Gis; 
dw; 
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2.2.4 Memory Allocation of Little Endian 
Memory is allocated to a data array using a little endian as follows. 


One-byte data (char and unsigned char type): The order of bits in one-byte data for a big 
endian and a little endian is the same. 


Two-byte data (short and unsigned short type): The upper byte and the lower byte will 
be reversed in two-byte data for a big endian and a little endian. 


Example: When a two-byte data 0x1234 is allocated in an address 0x 100: 


big endian: address 0x100: 0x12 little endian: address 0x100: 0x34 
address 0x101: 0x34 address 0x101: 0x12 


Four-byte data (int, unsigned int, long, unsigned long, and float type): The 
upper byte and the lower byte will be reversed in four-byte data for a big endian and a little endian. 


Example: When a four-byte data 0x12345678 is allocated in an address 0x100: 


big endian: address 0x100: 0x12 little endian: address 0x100: 0x78 
address 0x101: 0x34 address 0x101: 0x56 
address 0x102: 0x56 address 0x102: 0x34 
address 0x103: 0x78 address 0x103: 0x12 


Eight-byte data (double type): The order of eight-byte data will be reversed for a big endian 
and a little endian. 


Example: When a four-byte data 0x 123456789abcdef is allocated in an address 0x100: 


big endian: address 0x100: 0x01 little endian: address 0x100: Oxef 


address 0x101: 0x23 
address 0x102: 0x45 
address 0x103: 0x67 
address 0x104: 0x89 
address 0x105: Oxab 
address 0x 106: Oxcd 
address 0x107: Oxef 


address 0x101: Oxcd 
address 0x102: Oxab 
address 0x103: 0x89 
address 0x 104: 0x67 
address 0x105: 0x45 
address 0x106: 0x23 
address 0x107: 0x01 


Combined-Type Data: Members of combined-type data will be allocated in the same way as 
that of a big endian. However, the order of byte data of each member will be reversed according to 


the rule of data size. 


Example: When the following function exists in address 0x100: 


struct { 
short a; 


int b; 


izZ= {0X1 234, 


big endian: 


0x56789abc}; 


address 0x 100: 0x12 
address 0x101: 0x34 


address 0x102: empty area 
address 0x103: empty area 


address 0x 104: 0x56 
address 0x105: 0x78 
address 0x 106: 0x9a 
address 0x 107: Oxbe 


little endian: address 0x 100: 0x34 
address 0x101: 0x12 
address 0x 102: empty area 
address 0x103: empty area 
address 0x 104: Oxbe 
address 0x105: Ox9a 
address 0x 106: 0x78 
address 0x107: 0x56 


Bit field: Bit fields will be allocated in the same way as a big endian. However, the order of 
byte data in each area will be reversed according to the rule of data size. 


Example: When the following function exists in address 0x 100: 


struct { 


long a:16; 


unsigned int b:15; 


short ¢:5 


Jy= (1, 1, 1); 


big endian: address 0x100: 0x00 


address 0x101: 0x01 
address 0x 102: 0x00 
address 0x103: 0x02 
address 0x 104: 0x08 
address 0x105: 0x00 


address 0x 106: empty area 
address 0x 107: empty area 


little endian: address 0x100: 0x02 
address 0x 101: 0x00 
address 0x 102: 0x01 
address 0x 103: 0x00 
address 0x 104: 0x00 
address 0x 105: Ox08 
address 0x 106: empty area 
address 0x 107: empty area 
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2.3 Linkage with Assembly Programs 


The C compiler supports intrinsic functions such as access to the SH microcomputer registers as. 
Refer to section 3.2, Intrinsic Functions, in part II, CPROGRAMMING, for details on intrinsic 
functions. However, processes that cannot be written in C, such as the multiply and accumulate 
operation using the MAC instruction, should be written in assembly language and afterwards 
linked to the C program. 


This section explains two key items which must be considered when linking a C program to an 
assembly program: 


¢ External identifier reference 
¢ Function call interface 


2.3.1 External Identifier Reference 


Functions and variable names declared as external identifiers in a C program can be referenced or 
modified by both assembly programs and C programs. The following are regarded as external 
identifiers by the C compiler: 


¢ A global variable which has a storage class other than static 
¢ A variable name declared in a function with storage class extern 
¢ A function name whose storage class is other than static 


When variable names which are defined as external identifiers in C programs, are used in assembly 
programs, an underscore character (_) must be added at the beginning of the variable name (up to 
250 characters without the leading underscore). 
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Example 1: An external identifier defined in an assembly program 1s referenced by a C program 


¢ In an assembly program, symbol names beginning with an underscore character (_) are declared 
as external identifiers by an .EXPORT directive. 

¢ InaC program, symbol names (with no underscore character (_) at the head) are declared as 
external identifiers. 


Assembly program (definition) C program (reference) 


.EXPORT _a, _b extern int a,b; 
.SECTION D, DATA, ALIGN=4 
sDATA.Te: oh 


-DATA.L 1 


. END 





Example 2: An external identifier defined in a C program is referenced by an assembly program 


* InaC program, symbol names (with no underscore character (_) at the head) are defined as 
external identifiers. 

¢ In an assembly program, external references to symbol names beginning with an underscore 
character (_) are declared by an IMPORT directive. 


C program (definition) Assembly program (reference) 


int a; . IMPORT _a 
.SECTION P,CODE,ALIGN=2 
MOV .L A_a,R1l 
MOV .L @R1,RO 
#1,R0 


RO, @R1 
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2.3.2 Function Call Interface 


When either a C program or an assembly program calls the other, the assembly programs must be 
created using rules involving the following: 


1. Stack pointer 

2. Allocating and deallocating stack frames 

3. Registers 

4. Setting and referencing parameters and return values 


Stack Pointer: Valid data must not be stored in a stack area with an address lower than the 
stack pointer (in the direction of address H’0), since the data may be destroyed by an interrupt 
process. 


Allocating and Deallocating Stack Frames: In a function call (right after the JSR or the 
BSR instruction has been executed), the stack pointer indicates the lowest address of the stack used 
by the calling function. Allocating and setting data at addresses greater than this one must be done 
by the calling function. 


After the called function deallocates the area it has set with data, control returns to the calling 
function usually with the RTS instruction. The calling function then deallocates the area having a 
higher address (the return value address and the parameter area). 


After function call and after 
control returns from a function 


A Lower address 


Uy 
Wy : Area allocated by the called function 
Fagg (during function call) 
vaiue a 


enon SOO Inet 
LSA TL 


value.a : Area deallocated by the called function 
(after control returns from a function) 
|: Area deallocated by the calling function 


Upper address 





Figure 2.1 Allocation and Deallocation of a Stack Frame 
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Registers: Some registers change after a function call, while some do not. Table 2.6 shows 
how registers change according to the rules. 


Table 2.6 Rules on Changes in Registers After a Function Call 


Item 


Registers whose 
contents may change 


Registers whose 
contents may not 
change 


Registers Used in a 
Function 


RO to R7, FRO to FR11*, 
FPUL", and FPSCR”* 


R8 to R15, MACH, MACL, PR, and 
FR12 to FR15* 


Note: Indicates a register for SH3E floating point. 


Notes on Programming 


If registers used in a function 
contain valid data when a 
program calls the function, the 
program must push the data onto 
the stack or register before 
calling the function. The data in 
registers used in called function 
can be used freely without being 
saved. 


The data in registers used in 
functions is pushed onto the 
stack or register before calling 
the function, and popped from 
the stack or register only after 
control returns from the function. 
Note that data in the MACH and 
MACL registers are not 
guaranteed if the option 
macsave=0 is specified. 
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The following examples show the rules on register changes. 


¢ A subroutine in an assembly program is called by a C program 


Assembly program (called program) 


.EXPORT _sub 
-SECTION P, CODE, ALIGN=4 Data in those registers needed by the called 


MOV .L R14,@-R15 function is pushed onto the stack. 
MOV .L R13,@-R15 


ne #-8,R15 Function processing 

(Since data in registers RO to R7 is pushed onto 
a stack by the calling C program, the assembly 
program can use them freely without 


having to save them first.) 
#8,R15 


@R15+,R13 


@R15+,R14 Register data is popped from the stack. 





C program (calling program) 


extern void sub(); 
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¢ A function in aC program is called by an assembly program 


C program (called program) 


void sub() 


{ 


Assembly program (calling program) 


A_sub: 


«LMPORT 


STS .L 
MOV .L 
MOV 
MOV .L 
JSR 
NOP 
LDS.L 


.DATA.L 
. END 


_sub 
.SECTION P, CODE, ALIGN=2 


PR, @-R15 
R1,@(1,R15) 
R3,R12 
A_sub, RO 
@RO 


@R15+,PR 


_sub 





The called function name prefixed with (_) is 
declared by the .IMPORT directive. 


Store the PR register (return address storage 
register) when calling the function. 

If registers RO to R7 contain valid data, 

the data is pushed onto the stack or stored 

in unused registers. 


Calls function sub. 


The PR register is restored. 


Address data of function sub. 
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Setting and Referencing Parameters and Return Values: This section explains how 
to set and reference parameters and return values. The ways of setting and referencing parameters 
and return values for each function depend on whether or not the type of the parameter or the return 
value is declared explicitly. A prototype function declaration is used to declare parameters and 
returns values explicitly. 


This section first explains the general rules concerning parameters and return values, and then how 
the parameter area is allocated, and how areas are established for return values. 


¢ General rules concerning parameters and return values 
— Passing parameters 


A function is called only after parameters have been copied to a parameter area in registers 
or on the stack. Since the calling function does not reference the parameter area after 
control returns to it, the calling function is not affected even if the called function modifies 
the parameters. 

— Rules on type conversion 


Type conversion may be performed automatically when parameters are passed or a return 
value is returned. The following explains the rules on type conversion. 


Type conversion of parameters whose types are declared: 


Parameters whose types are declared by prototype declaration are converted to the 
declared types. 


Type conversion of parameters whose types are not declared: 


Parameters whose types are not declared by prototype declaration are converted according 
to the following rules. 


char, unsigned char, short, and unsigned short type parameters are converted to 
int type parameters. 


float type parameters are converted to double type parameters. 
Types other than the above cannot be converted to another type. 
Return value type conversion: 

A return value 1s converted to the data type returned by the function. 
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long = :) 
{ Float x; 
return x; ‘*——— The return value is converted to long by a 
prototype declaratio 
} 
(2) void p ( int ) 
oe ae, 
{ har c 
Bo 10s. 262 3 
} | Leen verted to int bec a type is not 
de eer the c parameter. 
1.0isc onverted to int because the type of 
the parameter is int. 


¢ Parameter area allocation 
Parameters are allocated to register when this sible, pe sured area. 
Figure 2.2 shows the parameter area ie ation ge pret n general parameter area 
allocatio 


Co: ZO eRe 


: WE Fro 
Parameter area YY ss 


(When CPU is SH3E) 





Figure 2.2 Parameter Area Allocation 
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Table 2.7 General Rules on Parameter Area Allocation 


Parameters Allocated to Registers 


Parameter Parameters 

Storage Registers Target Type Allocated to a Stack 

R4 to R7 char, unsigned char, (1) Parameters whose types are other 
short, unsigned short, int, | than target types for register passing 
unsigned int, long, (2) Parameters of a function which has 
unsigned long, float (when been declared by a prototype 
CPU is not SH3E), and pointer declaration to have variable-number 

parameters ° 
FR4 to FR11' float (when CPU is SH3E) (3) Other parameters are already 


allocated to R4 to R7. 
Notes: 1. Indicates a register for SH3E floating point. 


2. Ifa function has been declared to have variable-number parameters by a prototype 
declaration, parameters which do not have a corresponding type in the declaration and 
the immediately preceding parameter are allocated to a stack. 


Example: 


ine. £2 (ont, 1nt, int; int;.«-2) 3 


£2(a,b,c,x,y,Z); «——-x, y, and z are allocated to a stack. 
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¢ Parameter allocation 
— Allocation to parameter storage registers 


Following the order of their declaration in the source program, parameters are allocated to 
the parameter storage registers starting with the smallest numbered register. Figure 2.3 
shows an example of parameter allocation to registers. 


f(char a,int b) 
{ 


Not guaranteed 





Figure 2.3. Example of Allocation to Parameter Registers 


— Allocation to a stack parameter area 


Parameters are allocated to the stack parameter area starting from lower addresses, in the 
order that they are specified in the source program. 


Note: Regardless of the alignment determined by the structure type or union type, parameters are 
allocated using 4-byte alignment. Also, the area size for each parameter must be a 
multiple of four bytes. This is because the SH stack pointer is incremented or decremented 
in 4-byte units. 


Refer to appendix B, Parameter Allocation Example, for examples of parameter allocation. 


¢ Return value writing area 


The return value is written to either a register or memory depending on its type. Refer to table 
2.8 for the relationship between the return value type and area. 


When a function return value is to be written to memory, the return value is written to the area 
indicated by the return value address. The caller must allocate the return value setting area in 
addition to the parameter area, and must set the address of the former in the return value address 
area before calling the function (see figure 2.4). The return value is not written if its type is 
void. 
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Table 2.8 Return Value Type and Setting Area 


Return Value Type Return Value Area 

char, unsigned char, short, unsigned short, RO: 32 bits 

int, unsigned int, long, unsigned long, float, (The contents of the upper three bytes 
and pointer of char, or unsigned char and the 


contents of the upper two bytes of 
short or unsigned short are not 
guaranteed.) 

However, when the —rtnext option is 
specified, sign extension is performed 
for char or short type, and zero 
extension is performed for unsigned 
char or unsigned short type. 


FRO: 32 bits 
(When cpu is SH3E, and the return value 
is float type.) 


double, long double, structure, union Return value setting area (memory) 


i Lower address 


Return value 
address area Return value 


setting area 
(allocated by the 
calling side) 
Parameter 
area 


y Upper address 





Figure 2.4 Return Value Setting Area Used When Return Value Is Written to 
Memory 
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Section 3 Extended Specifications 


This section describes C compiler extended specifications: 


interrupt functions 

intrinsic functions 

section change function 
single-precision floating-point library 
Japanese description in string literals 
inline function 

inline expansion in assembly language 
specifying two-byte address variable 
specifying GBR base variable 

register save and recovery control 


global variable register allocation 


3.1 Interrupt Functions 


3.1.1 Description 


#pragma interrupt (function name [(interrupt specifications)] 


[, function name [(interrupt specifications)]]) 


A preprocessor directive (#pragma) specifies an external (hardware) interrupt function. The 
following section describes how to create an interrupt function. Since the interrupt operation of 
SH3 and SH3E differ from that of the SH1 and SH2, interrupt handlers are necessary. 
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Table 2.9 lists interrupt specifications. 


Table 2.9 Interrupt Specifications 


Item Form Options Specifications 
Stack switching  sp= <variable>| = The address of a new stack is specified with a variable 
specification &<variable> | or a constant. 


<constant> <variable>: Variable value 
&<variable>: Variable (pointer type) address 
<constant>: Constant value 


Trap-instruction = tn= <constant> —§ Termination is specified by the TRAPA instruction 
return <constant>: Constant value 
specification (trap vector number) 
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3.1.2 Explanation 


#pragma interrupt declares an interrupt function. An interrupt function will preserve register 
values before and after processing (all registers used by the function are pushed onto and popped 
from the stack when entering and exiting the function). The RTE instruction directs the function 
to return. However, if the trap-instruction return is specified, the TRAPA instruction 1s executed 
at the end of the function. An interrupt function with no specifications is processed in the usual 
procedure. The stack switching specification and the trap-instruction return specification can be 
specified together. 


Example: 
extern int STK[100]; 


int *ptr = STK + 100; 
#pragma interrupt ( f(sp=ptr, tn=10) ) 


(a) (b) 
Explanation: 
(a) Stack switching specification: ptr is set as the stack pointer used by interrupt 
function f. 


(b) Trap-instruction return specification: After the interrupt function has 
completed its processing, TRAPA #H'10 is executed. The SP at the beginning 
of trap exception processing is shown in figure 2.5. After the previous PC and 
SR (status register) are popped from the stack by the RTE instruction in the 
trap routine, control is returned from the interrupt function. 
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Immediately after interrupt 


Lower address ) 
STK[0] 


| STK] 


ptr —_ 


Upper address ' 


Lower address 


sp Previous PC 


Previous SR 


Upper address \ 


Figure 2.5 
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During interrupt function 
processing 


STK[0}] 


Previous PC 
Previous SR 


Just after the interrupt function 
has completed processing 
(Immediately before the TRAPA 
instruction is issued) 


Previous PC 
Previous SR 





Stack Processing by an Interrupt Function 


3.1.3 Notes 


1. Only global functions can be specified for an interrupt function definition and the storage class 
specifier must be extern. Even if storage class static is specified, the storage class is handled 
as extern. 

The function must return void data. The return statement cannot have a return value. If 
attempted, an error is output. 
Example: 

#pragma interrupt (f1(sp=100) , £2) 

void fl()(..}) cocrt ttt (a) 


bio Vee org © i Gers en eae a Pee ee A eee (b) 


Description: (a) is declared correctly. 
(b) returns data that is not void, thus (b) is declared incorrectly. An error 
is output. 


2. A function declared as an interrupt function cannot be called within the program. If attempted, 
an error is output. However, if the function is called within a program which does not declare 
it to be an interrupt function, an error is not output but correct program execution will not be 
guaranteed. 

Example (An interrupt function is declared): 
#pragma interrupt (f1) 
void f£1(void) {...} 
Int -f20 4 tee rere eee ee (a) 


Description: Function fl cannot be called in the program because it is declared as an 
interrupt function. An error is output at (a). 


Example (An interrupt function is not declared): 
int f£1(); 


int £21) ELC; p Coste eee (b) 


Description: Because function f1 is not declared as an interrupt function, an object for 
extern int f1(); is generated. If function f1 is declared as an interrupt function 
in another file, correct program execution cannot be guaranteed. 
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32 Intrinsic Functions 


The C compiler provides the intrinsic functions for the SH microcomputer, which (functions) are 
described below. 


3.2.1 Intrinsic Functions 
The following functions can be specified by intrinsic functions. 


¢ Setting and referencing the status register 
¢ Setting and referencing the vector base register 
e I/O functions using the global base register 


e System instructions which do not compete with register sources in C 


3.2.2 Description 


<machine.h>, <umachine.h>, or <smachine.h> must be specified when using intrinsic functions. 


3.2.3 Intrinsic Function Specifications 


Table 2.10 lists intrinsic functions. 
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Table 2.10 Intrinsic Functions 








based long word 


gbr_read_long(int offset) 


No Item Function Specification Description 
1 Status Setting the status void set_cr(int cr) Sets cr (32 bits) in 
register —_ register the status register 
(SR) 
2 Referencing to the int get_cr (void) Refers to the status 
status register register 
3 Setting the interrupt void set_imask(int mask) Sets mask (4 bits) in 
mask the interrupt mask (4 
bits) 
4 Referencing to the int get_imask(void) Refers to the 
interrupt mask interrupt mask (4 
bits) 
5 Vector Setting the vector void set_vbr(void **base) Sets “*base (32 
base base register bits) in VBR 
6 register ~~ Referencing to the void **get_vbr (void) Refers to VBR 
(VBR) vector base register 
7 Global Setting GBR void set_gbr(void *base) Sets “base (32 bits) 
base in GBR 
8 oat Referencing to GBR void *get_gbr (void) Refers to GBR 
9 Referencing to GBR- unsigned char Refers to byte data 
based byte gbr_read_byte(int offset) (8 bits) at the 
address indicated 
by adding GBR and 
the offset specified 
10 Referencing to GBR- unsigned short Refers to word data 
based word gbr_read_word(int offset) (16 bits) at the 
address indicated 
by adding GBR and 
the offset specified 
11 Referencing to GBR- unsigned long Refers to long word 


data (32 bits) at the 
address indicated 

by adding GBR and 
the offset specified 
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Table 2.10 Intrinsic Functions (cont) 








No Item Function Specification Description 
12 Global Setting GBR-based void gbr_write_byte Sets data (8 bits) at 
as byte (int offset, the address 
ogister unsigned char data) indicated by adding 
(GBR) GBR and the offset 
(cont) specified 
13 Setting GBR-based void gbr_write_word Sets data (16 bits) 
word (int offset, at the address 
unsigned short data) indicated by adding 
GBR and the offset 
specified 
14 Setting GBR-based void gbr_write_long Sets data (32 bits) 
long word (int offset, at the address 
unsigned long data) indicated by adding 
GBR and the offset 
specified 
15 AND of GBR base void gbr_and_byte ANDs mask with the 
(int offset, byte data at the 
unsigned char mask) address indicated 
by adding GBR and 
the offset specified, 
and then stores the 
result at the same 
address 
16 OR of GBR base void gbr_or_byte ORs mask with the 
(int offset, byte data at the 
unsigned char mask) address indicated 
by adding GBR and 
the offset specified, 
and then stores the 
result at the same 
address 
17 XOR of GBR base void gbr_xor_byte XORs mask with the 
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(int offset, 
unsigned char mask) 


byte data at the 
address indicated 
by adding GBR and 
the offset specified, 
and then stores the 
result at the same 
address 


Table 2.10 Intrinsic Functions (cont) 











No Item Function Specification Description 
18 Global TEST of GBR base int gbr_tst_byte ANDs mask with the 
base (int offset, byte data at the 
register unsigned char mask) address indicated 
(GBR) by adding GBR and 
(cont) the offset specified, 
and checks if the 
byte data at the 
offset from GBR is 0 
or not, and sets the 
result in the T bit 
19 Special SLEEP instruction void sleep (void) Expands the SLEEP 
instruc- instruction 
tions 
20 TAS instruction int tas(char *addr) Expands TAS.B 
@ addr 
21 TRAPA instruction int trapa(int trap_no) Expands TRAPA 
#trap_no 
22 ~=Special OS system call int trapa_svc ( Enables executing 
instruc- int trap_no, int code, HI-SH7 (Hitachi 
tions typel paral, type2 para2, Industrial Realtime 
(cont) type3 para3, type4 para4) Operating System 
trap-no: Trap number SH7000 Series) and 
code: Function code other OS system 
para 1 to 4: Parameter (0 to 4 calls. When 
variables) trapa_svc is 
type 1 to 4: Parameter type: executed, code is 
general integer or pointer type = specified in RO, and 
para 1 to para4 in R4 
to R7, respectively. 
Then, TRAPA 
#trap_no is 
executed. 
23 PREF instruction void prefetch (void *p) If the instruction is 


Note: The instruction is 
prefetched only when the 
compiler option cpu = sh3 is 
specified. 


prefetched, an area 
indicated by the 
pointer (16-byte 
data from 

(int)p& OxfffffffO) is 
written to the cache 
memory. This does 
not affect any 
programming logical 
operation. 
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Table 2.10 Intrinsic Functions (cont) 


No Item 

24 Mutiply and 
accumulate 
operation 

25 
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Function 


MAC.W 
instruction 


MAC.L 
instruction 


Specification 


int macw( 
short *ptrl, short *ptr2, 
unsigned int count) 


int macwli ( 
Short *ptrl, short *ptr2, 
unsigned int count, 
unsigned int mask) 
ptr1: Start address of data to 
be multipled or 
accumulated 
ptr2: Same as above 
count: Number of times the 
operation is performed 
mask: Address mask that 
correspond to the ring 
buffer 


int macl ( 
int *ptrl, int *ptr2, 
unsigned int count) 


int macll ( 

int *ptrl, int*ptr2, 
unsigned int count, 
unsigned int mask) 

The parameter specification is the 
same as those of No. 24. 

Note: macl and macil can be used 
only when the compiler option 
cpu = sh2, sh3, or sh@e is 
specified. 


Description 


A multiply and 
accumulate operation 
intrinsic function 
multiplies and 
accumulates 
contents of two data 
tables. 

Example: 

short tbli[(J= 
{al,a2,a3,a4}; 
short tbl2[]= 

{bl ,b2,b3,b4}; 

In this case, 
macw(tbl1, tbl2, 3) 
calculates a1*b1 
+a2*b2+a3*b3. Using 
a ring buffer 

function, tbl2 can be 
calculated 
recursively. The 
number of calculation 
times is 2". 

Example: 

When the data size is 
two bytes and the ring 
buffer mask is four 
bytes (Oxfffffffb or up 
to 0x4), macwl(tbl1, 
tbl2, 4, Oxftffffffb) is 
calculated as 
ai*b1+a2*b2+a3*b1+ 
a4*b2. 


>) 


.2.4 Notes 


. The offsets (excluding No. 15 to 18) and masks (excluding No.3) shown in table 2.10, Intrinsic 


Functions, must be constants. 

The specification range for offsets is +255 bytes when the access size 1s shown as a byte, +510 
bytes when the access size is shown as a word, and +1020 bytes when the access size 1s shown 
as a long word. 


Masks which can be specified for performing logical operations (AND, OR, XOR, or TEST) 
on a location relative to GBR (global base register) must be within the range of 0 to +255. 


As GBR 1s a control register whose contents are not preserved by all functions in this C 
compiler, take care when changing GBR settings. 


The multiply and accumulate operation’s instrinsic function does not check for parameters. 
Therefore, keep the following in mind: 


a. Tables indicated by ptrl and ptr2 must be aligned to sizes in 2 bytes and 4 bytes, 
respectively. 

b. Tables indicated by ptr2 in macwl and macwll must be aligned to the size of the ring buffer 
mask x 2. 
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3.2.5 Example 


#include <machine.h> 
#define CDATA1 0 

#define CDATA2 
#define CDATA3 
#define SDATAL 
#define IDATA1 
#define IDATA2 12 


Oo fF DY F 


struct { 
char cdatal; /* offset 0 */ 
char cdata2; /* offset 1 */ 
char cdata3; /* offset 2 */ 
short sdatal; /* offset 4 */ 
int idatal; /* offset 8 */ 
int idata2; /* offset 12 */ 
}table; 
void £(); 
void £() 
2 i 
set_gbr( &table); /* Set the start address of table to ars 
/* GBR. #7] 
gbr_write_byte( CDATA2, 10); /* Set 10 to table.cdata2. =) 
gbr_write_long( IDATA2, 100); /* Set 100 to table.idata2. =/ 
if(gbr_read_byte( CDATA2) != 10) /* Refer to table.cdata2. *] 
gbr_and_byte( CDATA2, 10); /* AND 10 and table.cdata2, and set e/. 
/* it in table.cdata2. */ 
gbr_or_byte( CDATA2, Ox0F); /* OR OxOF and table.cdata2, and set */ 
/* it in table.cdata2. Bf, 
sleep (); /* Expand to the sleep instruction aed 


72 HITACHI 


Effective Use of Intrinsic Functions: 
1. Allocate frequently accessed object to memory and set the start address of the object to GBR. 


2. In step 1., byte data frequently used in logical operations should be declared within 128 bytes of 
the start address of the structure. As a result, the following instructions can be reduced: start 
address load instruction necessary for structure accessing and load/store instructions necessary 
for performing logical operation. | 


3.2.6 Dividing <machine.h> 
<machine.h> is divided as follows to correspond to the SH3 execution mode: 


1. <machine.h>: Overall intrinsic functions 
2. <smachine.h>: Intrinsic functions that can be used in the privilege mode 


3. <umachine.h>: Intrinsic functions except <smachine.h>: 
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3.3 Section Change Function 


A section name to be output in a C program by the compiler can be changed using #pragma 
section. By using this section change function, you do not need to divide files in units of 
functions or variables to allocate addresses, which was required previously. The following explains 
more details on this function. 


3.3.1 Description 


#pragma section name | value 
<source program> 
#pragma section 


3.3.2 Explanation 


Specify a section name using #pragma section name or #pragma section value. A section after a 
declaration in a source program will be P section name + name (numeric value), D section name + 
name (numeric value), C section name + name (numeric value) and, B section name + name 
(numeric value). A default section name becomes valid after #pragma section 1s declared. 


3.3.3 Notes 


1. #pragma section must be specified outside the function declaration. 
2. A maximum of 64 section names can be declared in one file. 


3.3.4 Example 


#pragma section abc 


int a; /* a is allocated to section Babc. */ 
extern const int c=1; /* c is allocated to section Cabc. */ 
£( ) { /* £ is allocated to section Pabc. */ 
a=C; 
} 
#pragma section /* bis allocated to section B. a | 
int b; /* g is allocated to section P. ir 
g( ) { 
b=c; 
} 


In the above example, when the compile option section = P = PROG is specified, f and g are 
allocated to section PROGabc and PROG, respectively. 
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3.4 Single-Precision Floating-Point Library 


A single-precision floating-point library (mathf.h) can be used in addition to an ANSI standard 
floating-point library (math.h). The single-precision floating-point library consists of functions 
listed in table 2.11. 


3.4.1 Description 


A suffix f is added to a double-precision ANSI standard library function name to be a single- 
precision floating point library function name. If a parameter or return type is double or pointer 
to a double-type, it will be float or pointer to float, respectively. Other specifications are the 
same as those of the ANSI standard C library. 


3.4.2 Notes 


Before using this library, be sure to declare #include<mathf.h> and #include<math.h>. 
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Table 2.11 Function List of Single-Precision Floating-Point Library 


Function Name 

float acosf (float x) 

float asinf (float x) 

float atanf (float x) 

float atan2f (float y, float x) 
float cosf (float x) 

float sinf (float x) 

float tanf (float x) 

float coshf (float x) 

float sinhf (float x) 

float tanhf (float x) 

float expf (float x) 

float frexpf (float x, int *p) 


float Idexpf (float x, int i) 
float logf (float x) 

float log10f (float x) 

float modff (float x, float *p) 


float powf (float x, float y) 
float sqrtf (float x) 

float ceilf (float x) 

float fabsf (float x) 

float floorf (float x) 

float fmodf (float x, float y) 
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Description 





Anti cosine: acos x 

Anti sine: asin x 

Anti tangent: atan x 

Anti tangent of a result given by division: atan (x / y) 
Cosine: cos x 

Sine: sin x 

Tangent: tan x 

Hyperbolic cosine: cosh x 
Hyperbolic sine: sinh x 
Hyperbolic tangent: tanh x 
Exponential function: e* 


Divided into 0.5 and 1.0, and the square of two and multiplication: 
suppose result=frexp (x, p), x=2"p x result (0.5 < result < 1.0) 


Square of two and multiplication: x X 2! 
Natural logarithm: log x 
Common logarithm that has 10 as a base: log, 


Suppose result = modff (x, y), 
x is divided into integer *p and floating point result 


Square: x’ 

Positive square root: Vx 

Result given by rounding up numbers after a decimal point of x 
Absolute value: | x | 

Result given by rounding down numbers after a decimal point of x 


Reminder after division 
Suppose result = fmodf (x, y) and q quotient, 
x=qxy+ result 





3.5 Japanese Description in String Literals 


Japanese can be included in string literals. Select a character code of euc or sjis option. When 
this option is omitted, the default setting is specified as table 2.12. 


Table 2.12 Default Settings of Japanese Code 


Host Computer Default Settings 
SPARC EUC 

HP9000 / 7000 Shift JIS 

IBM-PC Shift JIS 


Note: The character code in the object program will be the same as that in the source program. 
Character constants cannot be specified in Japanese. 
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3.6 Inline Function 


A function name to expand at compilation is specified. 


3.6.1 Description 


#pragma inline (function name, ...) 


3.6.2 Explanation 


A function specified by #pragma inline or a function with specifier inline will be expanded where 
the function is called. However, a function will not be expanded where the function is called in the 


following cases: 


e a function definition exists before the #pragma inline specification 


e a function has a flexible parameter 


° aparameter address is referenced in a function 


e an address of a function to be expanded is used to call a function 


3.6.3 Notes 


1. Specify #pragma inline before defining a function. 


2. When a source program file includes an inline function description, be sure to specify static 
before the function declaration because an external definition is generated for a function 
specified by #pragma inline. If static is specified, an external definition will not be created. 


3.6.4 Example 


Source Program 
#pragma inline (func) 


int func (int a, int b) 


{ 
return (at+b)/2; 

} 

int x; 

mMain( ) 

{ 

x = func(10, 20); 

} 
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Inline expansion Image 
int x; 

main( ) 

{ 


int func_result; 


int a_l = 10, b_1 = 20; 


func_result = (a_1l+b_1)/2; 


} 
x = func_result; 


3.7 Inline Expansion in Assembly Language 


A function that is written in an assembly language is expanded where the function 1s called in a 
C source file. 


3.7.1 Description 


#pragma inline_asm (function name[(size=numeric value)], ...) 


3.7.2 Explanation 


Parameters of a function that is written in an assembly language are referenced from an inline_asm 
function because they are stacked or stored in registers in the same way as general function calls. 
A return value of a function that is written in an assembly should be set in RO. 

The specification (size=numeric value) specifies the size of the assembler inline function. 


3.7.3 Notes 


1. Specify #pragma inline_asm before defining a function. 

2. When a source program file includes an inline function description, be sure to specify static 
before the function declaration because an external definition is generated for a function 
specified by #pragma inline_asm. If static is specified, an external definition will not be 
created. 

3. Be sure to use local labels in a function written in an assembly language. 

4. When using registers R8 to R15 in a function written in an assembly language, the contents of 
these registers must be saved and recovered at the start and end of the function. 

5. Do not use RTS at the end of a function written in an assembly language. 

6. When using this function, be sure to compile programs using the object type specification 
option code=asmcode. 

7. When specifying a number by (size=numeric value), specify a number larger than the actual 
object size. If a value smaller than the actual object size is specified, correct operation will not 
be guaranteed. Ifa floating point or a numeric value below 0 is specified, an error will occur. 
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3.7.4 Example 


Source Program 


#pragma inline_asm(rot1) 


int rotl (int a) 
{ 
ROTL R4 
MOV R4, RO 
} 
int x; 
main( ) 


{ 


x = rotl (x); 
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0x55555555; 


Output Result (partial) 


_main 


MOV .L 
MOV .L 
MOV .L 
MOV .L 


NOP 
L220: 

.RES .W 

.DATA.L 

.DATA.L 
L219: 

ROTL 

MOV 

- ALIGN 

MOV .L 

RTS 

MOV .L 

. SECTION 


~RES.L 


;function main 

; frame size = 4 

R14, @-R15 

L220+2, R14; _x 

L220+6, R3 ; H’55555555 
R3, @R14 

R3, R4 

L219 


1 
x 


H'55555555 


R4 

R4, RO 
4 

RO, @R14 


@R15+, R14 

B, DATA, ALIGN=4 
;static: x 

1 


3.8 Specifying Two-byte Address Variables 


A variable can be allocated to a two-byte address area (H’0000000 to H’O007FFF and H’ FFF8000 
to H’ FFFFFFF). 


3.8.1 Description 


#pragma abs 16 (identifier, ...) 


3.8.2 Explanation 


A variable specified using an identifier or an address of a function is treated as 
two-byte data. Then, program size can be reduced. 


3.8.3 Notes 


1. Directive #pragma abs16 cannot be used to specify an automatic object. 


2. Wariables declared in directive #pragma abs16 must be allocated in addresses H’0000000 to 
H’0007FFF or H’FFF8000 to H’ FFFFFFF. 
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3.9 Specifying GBR Base Variables 


A variable is accessed using a GBR register with an offset value. 


3.9.1 Description 


#pragma gbr_base (variable name, ...) 
#pragma gbr_basel (variable name, ...) 


3.9.2 Explanation 


Variables specified by #pragma gbr_base and #pragma gbr_base] are allocated to sections $GO and 
$G1, respectively. The directive #pragma gbr_base is used when the variable is located in an offset 
of 0 to 127 bytes from the address specified by the GBR register. The directive #pragma gbr_basel 
is used when the variable is located in an offset of 128 or more bytes from the address specified in 
the GBR register, that is, when a variable is in a range that cannot be accessed by #pragma 
gbr_base. An offset value is 255 bytes at maximum for a char or unsigned char type, 510 
bytes at maximum for a short or unsigned short, and 1020 bytes at maximum for an int, 
unsigned, long, unsigned long, float, or double type. Based on the above specification, 
the compiler generates an object program in a GBR relative addressing mode that is optimized 
according to variable reference and settings. The compiler also generates an optimized bit 
instruction in the GBR indirect addressing to char or unsigned type data in the $GO section. 


3.9.3 Notes 


1. If the total program size after linking with section $GO exceeds 128 bytes, the correct operation 
will not be guaranteed. In addition, if there is data that has an offset value that exceeds those 
specified above for #pragma gbr_base1 in section $G1, correct operation will not be guaranteed. 


2. Section $G1 must be allocated immediately after 128 bytes of section $GO when linking. 


3. When using this function, be sure to set the start address of section $GO in the GBR register at 
the beginning of program execution. 
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3.10 Register Save and Recovery Control 


Register contents of a function can be saved or recovered. 


3.10.1 Description 


#pragma noregsave (function name, ...) 
#pragma noregalloc (function name, ...) 
#pragma regsave (function name, ...) 


3.10.2 Explanation 


1. Functions specified by #pragma noregsave do not save or allow the recovery of the contents of 
registers to guarantee their values (see table 2.6) at the beginning or end of a function. 


2. Functions specified by #pragma noregalloc do not save or allow the recovery of the contents of 
registers to guarantee their values at the beginning or end of a function, but do generate an 
object before or after the function call. Registers R8 to R14 are not allocated to the object. 


3. Functions specified by #pragma regsave do not save or allow the recovery of the contents of 
registers to guarantee their values at the beginning or end of a function, but do generate an 
object before or after the function call. Registers R8 to R14 are not allocated to the object. 


4. #pragma regsave and #pragma noregalloc can specify the same function at the same time. In 
this case, the contents of registers R8 to R14 that guarantee their values are saved and recovered 
at the beginning or end of a function, and generate an object before or after the function call. 
Registers R8 to R14 are not allocated to the object. 


5 Functions specified by #pragma noregsave can be used in the following conditions: 
a. A function is first activated and is not called from any other function. 
b. A function is called from a function that is specified by #pragma regsave. 


c. A function is called from a function that is specified by #pragma regsave via #pragma 
noregalloc. 


3.10.3 Notes 


If a function that is specified by #pragma noregsave is called in a way other than explained above, 
the obtained data is not guaranteed. 
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3.10.4 Example 


#pragma noregsave (f) 
#pragma noregalloc (g) 


#pragma regsave (h) 


h ( ) 
{ 

g (); 

£(); /* function call immediately after function call (f£) #pragma noregsave */ 
} /* from function (h) #pragma regsave */ 
g () 
{ 

a a /* function call (f) #pragma noregsave from function (h) #pragma */ 


/* yregsave through function (g) #pragma noregalloc a 


£ ( ) 


3.11 Global Variable Register Allocation 


Registers are allocated to global variables. 


3.11.1 Description 


#pragma global_register (<variable name>=<register name>, ...) 


3.11.2 Explanation 


This function allocates the register specified in <register name> to the global variable specified in 
<variable name>. 
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kk W tv 


3.11.4 Example 


.11.3 Notes 


#pragma global_register (x=R13,y=R14) 


int xX; 


char nV; 


funcl () 


X++; 


func2 () 


*y=0; 


func(int a) 


{ 


funcl (); 


func2 (); 


The specified variable cannot be referenced from the linked side. 


This function is used for a simple or pointer type variable in the global variable. Do not 
specify a double type variable unless -double=float option is specified. 


Only use registers R8 to R14 and FR12 to FRI5 (FR12 to FRI5: when using SH3E). 


The initial value cannot be set. In addition, the address cannot be referenced. 
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Section 4 Notes on Programming 


This section contains notes on coding programs for the C compiler and troubleshooting when 
compiling or debugging programs. 


4.1 Coding Notes 


4.1.1 float Type Parameter Function 


Functions must declare prototypes or treat float type as double type when receiving and passing 
float type parameters. Data cannot be preserved (guaranteed) when a float type parameter 
function without a prototype declaration receives and passes data. 


Example: 


void f (float); ------------------- (1) 
g () 
{ 
Float a; 
Ee Aay3 
) 
void 
£ (float x) 
( 


} 


Function f has a float type parameter. Therefore, a prototype must be declared as shown in (1) 
above. 


4.1.2 Program Whose Evaluation Order is Not Regulated 


The effect of the execution is not guaranteed in a program whose execution results differ depending 
on the evaluation order. 
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Example: 


a[fiJ=a[++i]; The value of i on the left side differs depending on whether the right 
side of the assignment expression is evaluated first. 


sub(++i, i); The value of 1 for the second parameter differs depending on whether 
the first function parameter 1s evaluated first. 


4.1.3. Overflow Operation and Zero Division 


At run time if overflow operation or zero division is performed, error messages will not be output. 
However, if an overflow operation or zero division is included in the operations for one or more 
constants, error messages will be output at compilation. 


Example: 
main () 
{ 
int la; 
int ib; 
float fa; 
float fb; 
ib=32767; 
fb=3 .4e+38f; 
/* Compilation error messages are output when an overflow operation pad 
/* and zero division are included in operations for one or more 7 
/* constants. ef 
1a=99999999999; /* (W) Detect integer constant overflow. ia 4 
fa=3 .5e+40f; /* (W) Detect floating pointing constant iy A 
/* overflow. a 
ia=1/0; /* (E) Detect division by zero. =) 
fa=1.0/0.0; /* (W) Detect division by floating point zero. */ 
/* No error message on overflow at execution is output. os 
ib=ib+32767; /* Ignore integer constant overflow. wy 
fb=fb+3.4e+38f; /* Ignore floating point constant overflow. */ 
} 
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4.1.4 Assignment to const Variables 


Even if a variable 1s declared with const type, if assignment is done to a variable other than 
const converted from const type or if a program compiled separately uses a parameter of a 
different type, the C compiler cannot detect the error 


Example: 
1. const char *p; /* 
/* 
/* 
streat(p, "abc") ;™ 
2. file 1 


const int i; 


file 2 

extern int i; /* 
/* 

i=10; /* 


Because the first parameter p in library 
function strcat is a pointer for char, 
the area indicated by the parameter p 


may change. 


In file 2, parameter i is not declared as 
const, therefore assignment to it in 


file 2 is not an error. 


4.1.5 Precision of Mathematical Function Libraries 


lf 
as 
ae 
*/ 


*7 
aed 
*/ 


For function acos (x) and asin (x), an error is x=1. Therefore, precautions must be taken. Note 


the error range below. 


Absolute error for acos (1.0—€) double precision 2” (¢ = 2°”) 
single precision 2” (€ =27") 


Absolute error for asin(1.0—€) double precision 2~° (€ = 2°”) 
single precision 2” (€ =2°'*) 
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4.2 Notes on Program Development 


Table 2.13 shows troubleshootings for developing programs from compilation through debugging. 


Table 2.13 Troubleshooting 


Check Points 


The section name which is output by 
the C compiler must be specified in 
capitals in start option of linkage 
editor. 


Trouble 


When linking, error 
314, cannot found 
section, is output 


When linking, error 
105, undefined 
external symbol, is 
output 


If identifiers are mutually referenced 
by a C program and an assembly 
program, an underscore must be 
attached to the symbol in the 
assembly program. 


Check if the C program uses a library 
function. 


An undefined reference symbol 
identifier must not start with a 
__(A run time routine in a standard 
library must be used.) 


Check if a standard I/O library 
function is used in the C program. 


Debugging at the C 
source level cannot 
be performed 


debug option must be specified at 
both compilation and linkage. 


A linkage editor of Ver.5.0 or higher 
must be used. 
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Solution 


Specify the 
correct 
section 
name. 


Refer to 
parameters 
with the 
correct 


parameters. 


Specify a 
standard 
library as 
the input 
library at 
linkage. 


Create low 
level 
interface 
routines for 
linking. 


Specify 
debug 
option at 
both 
compilation 


and linkage. 


Usea 
linkage 
editor of. 
Ver.5.0 or 
higher. 


References 


Section 2.1, 

Structure of Object 
Programs in part Il, 
C PROGRAMMING 


Section 2.3.1, 
External Identifier 
Reference, in part Il, 
C PROGRAMMING 


Standard library 
specification: 
Section 3.5, 
Correspondence to 
Standard Libraries, in 
part |, OVERVIEW 
AND OPERATIONS 


Routine: Section 2.1 


part Ill, SYSTEM 
INSTALLATION 


Section 4.6, Creating 
Low-Level Interface 
Routines, in part Ill, 
SYSTEM 
INSTALLATION 


Section 3.3, Compiler 
Options, in part |, 
OVERVIEW AND 
OPERATIONS 


Table 2.13 Troubleshooting (cont) 


Trouble 


When linking, error 
No. 108 relocation 
size overflow is 
output 


When linking, error 
No. 104 duplicate 
symbol is output 


Check Points 


Check if an offset value of a variable 
specified using a GBR base is within 
ine range. 


Check if a variable or function whose 
name is the same as that of other 
variables or functions exists in more 
than one file. 


Check if a variable or function is 
externally defined in a header file to 
be included in more than one file (the 
above is the same in the case of a 
function specified (#pragma inline/ 
inline_asm). 


Solution 


Delete 
#pragma 
gbr_base/ 
gbr_base1 
declaration 
for data 
beyond the 
range. 


Change the 
name of the 
variable or 
function, or 
specify 
Static. 


Specify 
static. 


References 


Section 3.9, 
Specifying GBR Base 
Variabies, in pait ti, 
C PROGRAMMING 


Section 3.6.3, Notes 
and 3.7.3, Notes, in 
part Il, 

C PROGRAMMING 
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PART Hl 
SYSTEM INSTALLATION 


Section | Overview of System Installation 


Part III describes how to install object programs generated by the C compiler on an SH system. 
Before installation, memory allocation and execution environment for the object program must be 
specified. 


Memory Allocation: Allocate a stack area, a heap area, and each section of a C-compiler- 
generated object program in ROM or RAM on a SH system. 


Execution Environment Setting for a C-Compiler-Generated Object Program: 
Set the execution environment by register initialization, memory area initialization, and C 
program initiation. Write these processing functions in assembly language. 

If C library functions such as the I/O function are used, library must be initialized when setting the 
execution environment specification. 


Section 2 describes how to allocate C programs in memory area and how to specify linkage editor's 
commands that actually allocate a program in memory area, using examples. 


Section 3 describes items to be specified in execution environment setting and execution 
environment specification programs. 


Section 4 describes how to create C library function initialization and low-level routines. 


Note: If I/O function (stdio.h) and memory allocation function (stdlib.h) are used, the user must 
create low-level I/O routines and memory allocation routines appropriate to the user 
system. 
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Section 2 Allocating Memory Areas 


To install an object program generated by the C compiler on a system, determine the size of each 
memory area, and allocate the areas appropriately to the memory addresses. 


Some memory areas, such as the area used to store machine code and the area used to store data 
declared using external definitions or static data members, are allocated statically. Other memory 
areas, such as the stack area, are allocated dynamically. 


This section describes how the size of each area is determined and how to allocate an area in 
memory. 


2.1 Static Area Allocation 


2.1.1 Data to be Allocated in Static Area 


Allocate sections of object programs such as program area, constant area, initialized data area, and 
non-initialized data area to the static area. 


2.1.2 Static Area Size Calculation 


Calculate the static area size by adding the size of C-compiler-generated object program and that of 
library functions used by the C program. After object program linkage, determine the static area 
size from each section size including library size output on a linkage map listing. Before object 
program linkage, the approximate size of the static area can be determined from the section size 
information on a compile listing. Figure 3.1 shows an example of section size information. 


x * x * * * * SECTION SIZE INFORMATION * * * * * * * 
PROGRAM  SECTION(P): 0x00004A Byte(s) 
CONSTANT SECTION(C) : 0x000018 Byte(s) 


DATA SECTION (D) : 0x000004 Byte(s) 
BSS SECTION (B) : 0x000004 Byte(s) 





TOTAL PROGRAM SIZE: Ox00006A Byte(s) 


Figure 3.1 Section Size Information 
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If the standard library is not used, calculate the static area size by adding the memory area size used 
by sections shown in section size information. However, if the standard library is used, add the 
memory area used by the library functions to the memory area size of each section. The standard 
library includes C library functions based on the C language specifications and arithmetic routines 
required for C program execution. Accordingly, link the standard library to the C source program 
even if library functions are not used in the C source program. 


The C compiler provides the standard library including C library functions (based on the C 
language specifications), and arithmetic routines (runtime routines required for C program 
execution). The size required for run time routines must also be added to the memory area size in 
the same way as C library functions. 


The run time routine used by the C programs are output as external reference symbols in the 
assembly programs generated by the C compiler (option code = asmcode). The user can see the 
run time routine names used in the C programs through the external reference symbols. 


The following shows the example of C program and assembly program listings. 


C program 


f( int a, int b) 
{ 


a /= b; 


return a; 
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Assembly program output by the C compiler 


divls ; An external reference definition for the run time routine 


—_—_ — ’ 


. EXPORT £ 


. SECTION P, CODE, ALIGN=4 





;function: f 
;frame size=4 
jused runtime library name: 
;_ _divls 
PR, @-R15 
R5, RO 


L218, R3 
@R3 

R4, R1 
@R15+, PR 


In the above example divls is a run time routine used in the C program. 


9 me ee 
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2.1.3 ROM and RAM Allocation 


When allocating a program to memory, allocate static areas to either ROM and RAM as shown 
below. 


Program area (section P): ROM 

Constant area (section C): ROM 

Non-initialized data area (section B): RAM 

Initialized data area (section D): ROM and RAM (for details, refer to the following section) 


2.1.4 Initialized Data Area Allocation 
The initialized data area contains data with initial value. Since the C language specifications allow 
the user to modify initialized data in programs, the initialized data area must be allocated to ROM 


when linking and is copied to RAM before program execution. Therefore, the initialized data area 
must be allocated in both ROM and RAM. 


However, if the initialized data area contains only static variables that are not modified during 
program execution, the initialized data needs to be allocated only to the ROM area. In this case, 
the data does not need to be allocated to the RAM area. 


2.1.5 Memory Area Allocation Example and Address Specification at Program 
Linkage 


Each program section must be addressed by the option or subcommand of the linkage editor when 
the absolute load module is created, as described below. 


Figure 3.2 shows an example of allocating static areas. 
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0x0000000 
Interrupt vector 


Sara area ROM 


is i area 


0x9000000 P.C,D,B: Default section name 


ater a area generated by the 


C compiler 


Non-initialized . 
data area R: Section name specified 
(B) by the linkage editor 
ROM support function 





OxFFFF800 





OxFFFFFFF 


Figure 3.2 Static Area Allocation 


Specify the following subcommands when allocating the static area as shown in figure 3.2. 


ROMA(D,R) ere een (1) 


STARTAP,C,D(400) ,R,B(9000000) -------- (2) 
Description: 


(1) Define section R having the same size as section D, in the output load module. To reference 
the symbol allocated to section D, reallocate to the address of section R and reference to the 
symbol in section R. Sections D and R are allocated to initialized data section in ROM and 
RAM, respectively. 

(2) Allocate sections P, C, and D to internal ROM starting from address 0x400 and allocate 
sections R and B to RAM starting from address 0x9000000. 
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2.2 Dynamic Area Allocation 


2.2.1 Dynamic Areas 


Two types of dynamic areas for C program are used: 


1. Stack area 
2. Heap area (used by the memory allocation library functions) 


2.2.2 Dynamic Area Size Calculation 


Stack Area: The stack area used in C programs is allocated each time a function is called and is 
deallocated each time a function is returned. The total stack area size 1s calculated based on the 
stack size used by each function and the nesting of function calls. | 


Stack Area Used by Each Function: The object list (frame size) output by the C compiler 
determines the stack size used by each function. The following example shows the object list, 
stack allocation, and stack size calculation method. 


Example: The following shows the object list and stack size calculation in a C program. 


extern int h(char, int *, double); 


int h(char a, register int *b, double c) 


{ 
char *ds 
d= &a; 
h(*d,b,c) ; 


{ 


register int i; 


i= *d; 


return i; 
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KAKA KKK KK KKK OBJECT LISTING RKEKKKKKEKKKK 


FILE NAME: m0251.c 


Sct OFFSET CODE C LABEL INSTRUCTION OPERAND COMMENT 
P 
00000000 eh: ; function: h 
; frame size=20 
00000000 £2FE6 MOV.L R14,@-R15 
00000002 4F22 STS.L  PR,@-R15 
Lower t 
address 


R15(SP) —> 0 


Area used 


within a 
function 


20 





Upper | 
address mak 


The size of the stack area used by a function is equal to frame size. Therefore, in the above 
example, the stack size used by the function h is 20 bytes which is shown as frame size = 20 


in COMMENT in OBJECT LISTING. 


For details on the size of parameters to be pushed onto the stack, refer to the description of 
parameter and return value setting and referencing in section 2.3.2, Setting and Referencing 


Parameters and Return Values, Function Call Interface, in Part IJ, C Programming. 
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Stack size calculation: The following example shows a stack size calculation depending on 
the function call nesting. 


Example: Figure 3.3 illustrates the function call nestings and stack size. 


Function Name Stack Size (Bytes) 


main 24 
f 32 


g 24 





Figure 3.3. Nested Function Calls and Stack Size 


If function g is called via function f, the stack area size is calculated according to the formula listed 
in table 3.1. 


Table 3.1 Stack Size Calculation Example 


Call Route Sum of Stack Size (Bytes) 
main (24) - f (32) > g (24) 80 
main (24) + g (24) 48 


As can be seen from table 3.1, the maximum size of stack area required for the longest function 
calling route should be determined (80 bytes in this example) and this size of memory should be 
allocated in RAM. 


When using standard library functions, the stack area sizes for library functions must also be 
accounted for. Refer to the Standard Library Memory Stack Size Listing, included with the 
C compiler package. 


Note: If recursive calls are used in the C source program, first determine the stack area required 
for a recursive call, and then multiply the size with the maximum number of recursive 
calls. 
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Heap Area: The total heap area required is equal to the sum of the areas to be allocated by 
memory management library functions (calloc, malloc, or realloc) in the C program. An 
additional 4 bytes must be summed for one call because a 4-byte management area is used every 
time a memory management library function allocates an area. 


An //O itbrary function uses memory management library functions for internai processing. The 
size of the area allocated in an input/output is determined by the following formula: 516 bytes x 
(maximum number of simultaneously open files) 


Note: Areas released by the free function, which is a memory management library function, can 
be reused. However, since these areas are often fragmented (separated from one another), a 
request to allocate a new area may be rejected even if the net size of the free areas is 
sufficient. To prevent this, take note of the following: 

1. If possible, allocate the largest area first after program execution Is Started. 
2. If possible, make the data area size to be reused constant. 


2.2.3 Rules for Allocating Dynamic Area 


The dynamic area is allocated to RAM. The stack area is determined by specifying the highest 
address of the stack to the vector table, and refer to it as SP (stack pointer). Since the interrupt 
operation of the SH3 and SH3E differ from that of the SH1 and SH2, interrupt handlers are 
necessary. The heap area is determined by the initial specification in the low-level interface routine 
(sbrk). For details on stack and heap areas, refer to section 3.1, Vector Table Setting 
(VEC_TBL), and section 4.6, Creating Low-Level Interface Routine in part I, System 
Installation, respectively. 
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Section 3 Setting the Execution Environment 


This section describes the environment required for C program execution. A C program 
environment specification program must be created according to the user system specifications 
because the C program execution environment differs depending on the user system. In this 
section, basic C program execution specification, where no C library function is used, is described 
as an example. Refer to section 4, Setting the C Library Function Execution Environment in part 
II, System Installation, for details on using C library functions when using C library functions, 
low-level I/O interface routine, or memory allocation routine. 


Figure 3.4 shows an example of program configuration. 


Power-on reset 


[| : Required routine 


_1 : Required table 


Figure 3.4 Program Configuration (No C Library Function is Used) 





Each routine is described below. 


Vector table setting (VEC_TBL) (shown as (1) in figure 3.4): Sets the vector table 
SO as to initiate register initialization program _ INIT and set the stack pointer (SP) by power- 
on reset. Since the interrupt operation of the SH3 and SH3E differ from those of the SH1 and 
SH2, interrupt handlers are necessary. 


Initialization (_ _INIT) (shown as (2) in figure 3.4): Initializes registers and 
sequentially calls initialization routines. 


Section initialization (__INITSCT) (shown as (3) in figure 3.4): Clears the non- 
initialized data area with zeros and copies the initialized data area in ROM to RAM. 


The following describes how each process is implemented (in the order as described above). 
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3.1 Vector Table Setting (VEC_TBL) 


To call register initialization routine _ INIT at power-on reset, specify the start address of 
function _ _INIT at address 0 in the vector table. Also to specify the SP, specify the highest 
address of the stack to address H'4. Since the interrupt operation of the SH3 and SH3E differ from 
those of the SH1 and SH2, interrupt handlers are necessary. When the user system executes 
interrupt handling, interrupt vector settings are also performed in the VEC_TBL routine. The 
coding example of VEC_TBL is shown below. 


Example: 


- SECTION VECT, DATA, LOCATE=H ‘0000 
; Assigns section VECT to address H'0 by the SECTION directive. 


. IMPORT _ _INIT 
. IMPORT _IRQO 
.DATA.L _ _INIT ; Assigns the start address of _ _INIT to addresses H'0x0 to H'0x3. 
.DATA.L (a) ; Assigns the SP to addresses H'0x4 to H'0x7. 
; (a): The highest address of the stack 
. ORG H'00000100 
.DATA.L _IRQO ; Assigns the start address of IRQO to addresses H'0x100 to H'0x103 
. END 
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3.2 Initialization (_ _INIT) 


_ _INIT initializes registers, calls initialization routine sequentially, and then calls the main 
function. The coding example of this routine is shown below. 


Example: 


extern void _INITSCT (void); 


extern void main (void) ; 


void _INIT() 
{ 
_INITSCT(); /* Calls section initialization routine x / 
/* _INITSCT. */ 
main(); /* Calls main routine _main. yf 
FOr () <4. 3 /* Branches to endless loop after executing main */ 
; /* function and waits for reset. */ 
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3.3 Section Initialization (_ _INITSCT) 


To set the C program execution environment, clear the non-initialized data area with zeros and 
copy the initialized data area in ROM to RAM. To execute the __INITSCT function, the 
following addresses must be known. 


e Start address (1) of initialized data area in ROM. 
¢ Start address (2) and end address (3) of initialized data area in RAM 
e Start address (4) and end address (5) of non-initialized data area in ROM 


Address 0 
Interrupt vector 


(P) 
(C) 
(D) 


initialized data area 
(R) 
Non-initialized 
data area 
B 


Dynamic area 
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To obtain the above addresses, create the following assembly programs and link them together. 


.SECTION D, DATA, ALIGN=4 
.SECTION R, DATA, ALIGN=4 
.SECTION  B, DATA, ALIGN=4 
.SECTION C, DATA, ALIGN=4 


_ _D_ROM .DATA.L (STARTOF D) 


; start address of section D 


_D_BGN . DATA.L (STARTOF R) 


; start address of section R 


_D_END .DATA.L (STARTOF R) + (SIZEOF R) 


; end address of section R 


_B_BGN .DATA.L (STARTOF B) 


; start address of section B 


_B_ END .DATA.L (STARTOF B) + (SIZEOF B) 


; end address of section B 


Notes: 1. 


.EXPORT _ _D_ROM 
-EXPORT _ _D_BGN 
-EXPORT _ _D_END 
-EXPORT _ _B_BGN 
-EXPORT _ _B_END 
. END 


(1) 


(2) 


(3) 


(4) 


(5) 


Section names B and D must be the non-initialized data area and initialized data area 


section names specified with the compiler option section. B and D indicate the 


default section names. 


2. Section name R must be the section name in RAM area specified with the ROM 


option at linkage. R indicates the default section name. 


If the above preparation is completed, section initialization routine can be written in C as shown 


below. 
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Example: 


Section initialization routine 


extern int *_D_ROM, *_B_BGN, *_B_END, * D_BGN, *_D_END; 
extern void _INITSCT( ) 
{ 

int: *p,; *q-; 


/* Non-initialized data area is initialized to zeros */ 


for (p = _B_BGN ; p < _B_END ; p++) 
*p = 0 ; 


/* Initialized data is copied from ROM to RAM */ 


for (p = _D_BGN , q = _D_ROM ; p < _D_END ; p++, q++) 


*q 





Note: The declaration of p and q must be a char* type when the section size is not a multiple of 
four bytes. 
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Section 4 Setting the C Library Function 
Execution Environment 


To use C library functions, they must be initialized to set the C program execution environment. 
To use I/O (stdio.h) and memory allocation (stdlib.h) functions, or to use the C library 
function to terminate program processing, low-level I/O and memory allocation routines must be 
created for each system. 


This section describes how to set the C program execution environment when C library functions 
are used. Figure3.5 shows the program configuration when C library functions are used. 


Power-on reset 


: Table always required 
: Routine always required 


: Routine required when library 
is used 


Z, 
: Supplied by the C compiler Y Low-level 


interface // 
yy 





Figure 3.5 Program Configuration When C Library Functions are Used 
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To use aC library function exit, onexit, or abort, which performs program termination 
processing, the C library function that corresponds to the user system must be created beforehand. 
For details on a program example, refer to Appendix D, Creating Termination Functions. If you 
use aC library function assert macro, you must create an abort function first. | 


Each routine is required to execute library functions as follows. 


Vector Table Setting (VEC_TBL): Sets the vector table to initiate register initialization 
program (_ _INIT) and set the stack pointer (SP) at power-on reset. Since the interrupt of the 
SH3 and SH3E differ from the SH1 and SH2, interrupt handlers are necessary. 


Initializing Registers (_ INIT): Initializes registers and sequentially calls the 
initialization routines. 


Initializing Sections (_ _INITSCT): Clears non-initialized data area with zeros and copies 
the initialized data area in ROM to RAM. 


Initializing C Library Functions (__INITLIB): Initializes C library functions required 
to be initialized and prepares standard I/O functions. 


Closing Files (__CLOSEALL): Closes all files with open status. 


Low-Level Interface Routine: Interfaces library functions and user system when standard 
I/O and memory management library functions are used. 


Creation of the above routines is described below. 
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4.1 Vector Table Setting (VEC_TBL) 


Same as when no C library function is used. For details, refer to section 3, Setting the Execution 


Environment, in part III, System Installation. 


4.2 Initializing Registers (_ _INIT) 


Initializes registers and sequentially calls the initialization routine _ INITLIB and file closing 
routine _ CLOSEALL. The coding example of _ _INIT is shown below. Since the 
interrupt operation of the SH3 and SH3E differ from those of the SH! and SH2, interrupt handlers 


are necessary. 
Example: 


extern void _INITSCT (void) ; 
extern void _INITLIB(void) ; 
extern void main(void) ; 


extern void _CLOSEALL (void) ; 


void _INIT (void) 


{ 
_INITSCT (); /* Calls section initialization routine _ _INITSCT. 
_INITLIB(); /* Calls library initialization routine _ _INITLIB. 
main(); /* Calls C program main function _main. 
_CLOSEALL () ; /* Calls file close routine _ _CLOSEALL. 
£or( 4 /* Branches to endless loop after executing main 


; /* function and waits for reset. 


4.3 Initializing Sections (__INITSCT) 


“/ 


*/ 


a 2 


aly f 


a 


a] 


Same as when the C library functions are not used. For details, refer to section 3, Setting the 


Execution Environment in part III, System Installation. 
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4.4 Initializing C Library Functions (__INITLIB) 


Some C library functions must be initialized before being used. The following description 
assumes the case when the initialization is performed in __INITLIB in the program initiation 
routine. 


To perform initialization, the following must be considered. 


1. errno indicating the library error status must be initialized for all library functions. 


2. When using each function of <stdio.h> and assert macro, standard I/O library function must 
be initialized. The low-level interface routine must be initialized according to the user low-level 
initialization routine specification if required. 


3. When using the rand and strtok functions, library functions other than the standard I/O must 
be initialized. 


Library function initialization program example is shown below. 
Example: 

#include <errno.h> 

extern void _INIT_LOWLEVEL (void) ; 


extern void _INIT_IOLIB(void) ; 
extern void _INIT_OTHERLIB(void) ; 


void _INITLIB(void) /* Deletes an underline from symbol name */ 
/* used in the assembly routine x, 
{ 
errmo=0; © /* Initializes library functions commonly */ 
_INIT_LOWLEVEL( ) ; /* Calls low-level interface a / 
/* initialization routine as 
_INIT_IOLIB( ) ; /* Calls standard I/O initialization af 
/* routine i 4 
_INIT_OTHERLIB( ) ; /* Calls initialization routine other a 4 
/* than that for standard I/O a A 
} 
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The following shows examples of initialization routine (_INIT_IOLIB) for standard I/O library 
function and initialization routine (_INIT_OTHERLIB) for other standard library function. 
Initialization routine (_INIT_.LOWLEVEL) for low-level interface routine must be created 
according to the user low-level interface routine's specifications. 


4.4.1 Creating Initialization Routine (_INIT_IOLIB) for Standard I/O Library 
Function 


The initialization routine for standard I/O library function initializes FILE-type data used to 
reference files and open the standard V/O files. The initialization must be performed before opening 
the standard I/O files (figure 3.6). 


The following shows an example of _INIT_IOLIB. 
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Example: 
#include <stdio.h> 
void _INIT_IOLIB (void) 
FILE *fp ; 
/*Initializes FILE-type data*/ 


for (fp=_iob; fp<_iob+_NFILE; fp++t) { 


fp -> _bufptr=NULL ; /*Clears buffer pointer */ 
fp -> _bufcnt=0 ; | /*Clears buffer counter x7] 
fp -> _buflen=0 ; /*Clears buffer length =f 
fp -> _bufbase=NULL ; /*Clears base pointer * / 
fp -> _ioflagl=0 ; /*Clears I/O flag * / 
fp -> _ioflag2=0 ; 
fp -> _iofd=0 ; 
} 
/*Opens standard I/O file */ 
| 
1f (freopen( "stdin" , "r", stdin)==NULL) /*Opens standard input file */ 
stdin->_ioflagl=Oxff ; /*Disables file access*2  */ 
stdin->_ioflagl |= _IOUNBUF ; /*No data buffering*3 */ 


=| 


if (freopen( “stdout" , "w", stdout)==NULL)/*Opens standard output file*/ 


stdout-> _ioflagl=0xff ; 
stdout->_ioflagl |= _IOUNBUF ; 
*] 


if (freopen( "stderr", "w", stderr)==NULL) /*Opens standard error file */ 


stderr-> _ioflagl=Oxff ; 
stderr->_ioflagl |= _IOUNBUF ; 
} 


Notes: 1. Standard I/O file names are specified. These names are used by the low-level interface 


routine open. 
2. If file could not be opened, the file access disable flag is set. 


3. For equipment that can be used in interactive mode such as a console, the buffering 


disable flag is set. 
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/*Declares FILE-type data in the C language*/ 


#define _NFILE 20 
struct _iobuf { 


unsigned char *_bufptr; /*Buffer pointer xy 
long _bufent; /*Buffer counter */ 
unsigned char *_bufbase; /*Buffer base pointer */ 
long _buflen; /*Buffer length «) 
char _loflagl; /*I/O flag ais 
char _loflag2; /*I/O flag “7 
char -TOEd? /*I/O flag my. 


}_iob[_NFILE] ; 


Figure 3.6 FILE-Type Data 


4.4.2 Creating Initialization Routine (_INIT_.OTHERLIB) for Other Library 


Function 


The following shows an example of initial setting program of C library function (rand function 
and strtok function) that is necessary for initial setting beside the standard I/O. 


#include <stddef.h> 


extern char *_slptr; 


extern void srand(unsigned int) ; 


void _INIT_OTHERLIB (void) 


{ 
srand(1) ; /*Sets initial value when rand function is used*/ 
_slptr=NULL ; /*Initializes the pointer used in the strtok lef 
/* function * / 

} 


HITACHI 119 


4.5 Closing Files (_ CLOSEALL) 


When a program ends normally, all open files must be closed. Usually, the data destined for a file 
is stored in a memory buffer. When the buffer becomes full, data is output to an external storage 
device. Therefore, if the files are not closed, data remaining in buffers 1s not output to external 
storage devices and will be lost. 


When an program is installed in a device and executed, the program will not end unless it finishes 
its operation. However, if the main function is terminated by a program error, all open files must 
be closed. 


The following shows an example of _ CLOSEALL. 
Example: 


#include <stdio.h> 


void _CLOSEALL (void) /* Deletes an underscore character * / 


/* from symbol name in assembly routine */ 


{ 
int i; 
for (i=0; i<_NFILE; i++) 
/*Checks that file is open*/ 
if (_iob[i]._ioflagl & ( _IOREAD|_IOWRITE|_IORW) ) 
/*Closes open files*/ 
fclose(&_iob[i]) ; 
} 
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4.6 Creating Low-Level Interface Routines 


Low-level interface routines must be supplied for C programs that use the standard input/output or 
memory management library functions. Table 3.2 shows the low-level interface routines used by 
standard library functions. 


Table 3.2 Low-Level Interface Routines 


Name Explanation 

open Open a file 

close Close a file 

read Reads data from a file 

write Writes data to a file 

Iseek Sets the file read/write position for data 
sbrk Allocates a memory area 


Refer to the attached Standard Library Memory Stack Size Listing for details on low-level interface 
routines required for each C library function. 


Initialization of low-level interface routines must be performed when the program is started. For 
more information, see the explanation concerning the _INIT_.LOWLEVEL function in section 
4.4, Initializing C Library Functions (_ INITLIB). 


The rest of this section explains the basic concept of low-level input and output, and gives the 
specifications for each interface routine. Refer to appendix E, Examples of Low-Level Interface 
Routines, for details on the low-level interface routines that run on the SH-series simulator 
debugger. 
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4.6.1 Concept of I/O Operations 


Standard input/output library functions manage files using the FILE-type data. Low-level 
interface routines manage files using file numbers (positive integers) which correspond directly to 
actual files. 


The open routine returns a file number for a given file name. The open routine must determine the 
following, so that other functions can access information about a file using the file number: 


¢ File device type (console, printer, disk, etc.) 
(For a special device such as a console or printer file, the user chooses a specific file name that 
can be recognized uniquely by the open routine.) 

¢ Information such as the size and start address of the buffer used for the file 


¢ For a disk file, the offset (in bytes) from the beginning of the file to the next read/write 
position. 


The input and output is determined by the read and write routine, respectively, or the start 
position for read/write operations is determined by the Iseek routine according to the information 
determined by the open routine. 


If buffers are used, the close routine outputs the contents to their corresponding files. This 
allows the areas of memory allocated by the open routine to be reused. 
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4.6.2 Low-Level Interface Routine Specifications 


This section explains the specifications for creating low-level interface routines, gives examples of 
actual interfaces and explains their operations, and notes on implementation. 


The interface for each routine is shown using the format below. 
Create each interface routine by assuming that the prototype declaration is made. 
Example: 


(Routine name) 


Purpose (Purpose of the routine) 
Interface (Shows the interface as a C function declaration) 
Parameters No. Name Type Meaning 
1 (Parametername) (Parameter (Meaning of the parameter) 
type) 
Return value Type (Type of return value) 
Normal (Return value for normal termination) 
Abnormal (Return value for abnormal termination) 
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open routine 


Purpose Opens a file 
Interface int open (char *name, 
int mode); 
Parameters No. Name Type Meaning 
1 | name Pointer to String literal indicating a file name 
char 
2 mode int Processing specification 
Return value Type int 
Normal File number of the file opened 
Abnormal —1 


Explanation: The open routine opens the file specified by the first parameter (file name) and 
returns a file number. The open routine must determine the file device type (console, printer, 
disk, etc.) and assign this information to the file number. The file type is referenced using the file 
number each time a read/write operation is performed. 


The second parameter (mode) gives processing specifications for the file. The effect of each bit of 
this parameter is explained as follows: 
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S432) 1.0 


31 
model 


O_RDONLY 
O_WRONLY 
| iW____. 9 RDWR 
O_CREATE 
O_TRUNC 
O_APPEND 


Description: 
(1) O_RDONLY (bit 0) 
If this bit is 1, the file becomes read only. 
(2) O_WRONLY (bit 1) 
If this bit is 1, the file becomes write only. 
(3) O_RDWR (bit 2) 
If this bit is 1, the file becomes read/write. 
(4) O_CREATE (bit 3) 
If this bit is 1 and the file indicated by the file name does not exist, a new file is created. 
(5) O_TRUNC (bit 4) 
If this bit is 1 and the file indicated by the file name exists, the file contents are discarded and 
the file size is set to zero. 
(6) O_APPEND (bit 5) 
If this bit is 1, the read/write position is set to the end of the file. If this bit is 0, the 
read/write position is set to the beginning of the file. 


An error is assumed if the file processing specifications contradict with the actual characteristics of 
the file. 


The open routine returns a file number (positive integer) which can be used by the read, write, 
Iseek, and close routines, provided the file opens normally. The relationship between file 
numbers and actual files must be managed by the low-level interface routines. The open routine 
returns a value of —1 if the file fails to open properly. 


HITACHI 125 


close routine 





Purpose Closes a file 
Interface int close(int fileno) ; 
Parameters No. Name Type Meaning 
1 fileno int File number of the file to be closed 
Return value Type int 
Normal 0 
Abnormal —1 


Explanation: The file number, determined by the open routine, is given as the parameter. 
Release the area of memory allocated by the open routine for file management information, so 
that it can be reused. If buffers are used, the contents are output to their corresponding files. Zero 
is returned if the file closes normally. Otherwise, —1 is returned. 
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read routine 


Purpose Reads data from a file 





Interface int read (int fileno, 
char *buf, 
unsigned int count}; 


Parameters No. Name Type Meaning 
1 fileno int File number of the file to be read 
2 buf Pointer to Area to be used to store the read data 
char 
3 count unsigned Byte length of data to be read 
int 
Return value Type int 
Normal Byte length of the data actually read 
Abnormal -1 


Explanation: The read routine loads data from the file indicated by the first parameter (fileno) 
into the area indicated by the second parameter (buf). The amount of data to be read is indicated by 
the third parameter (count). If an end of file is encountered during a read, less than the specified 
number of bytes are read. The file read/write position is updated using the byte length of the data 
actually read. If data is read normally, the routine returns the number of bytes of the data read. 
Otherwise, the read routine returns a value of —1. 
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write routine 


Purpose Writes data to a file 
Interface | int write (int fileno, 
char *buf, 


unsigned int count) ; 


Parameters No. Name Type Meaning 
| 1 fileno int File number 
2 Gut Pointer to char Area storing data to be written 
in the file 
3 count unsigned int Byte length of the data to be 
written 
Return value Type int 
Normal Byte length of the data actually written 
Abnormal —1 


Explanation: The write routine outputs data, whose byte length is indicated by the third 
parameter (count), from the area indicated by the second parameter (buf) into the file indicated by 
the first parameter (fileno). If the device (such as a disk) where a file is stored becomes full, data 
less than the specified byte length is written to the file. If zero is returned as the byte length of 
data actually written several times, the routine assumes that the device is full and sends a return 
value of -1. The file read/write position is updated using the byte length of data actually written. 
If the routine ends normally, it returns the byte length of data actually written. Otherwise, the 
routine returns a value of —1. 
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Iseek routine 





Purpose Determines the next read/write position in a file 
Interface long lseek (int fileno, 
long offset, 
int base); 
Parameters No. Name Type Meaning 
1 fileno int File number of the target file 
2 offset long Offset in bytes from specified point in 
the file 
3 base int Base used for offset (bytes) 
Return value Type long 
Normal The offset (bytes) from the beginning of the file for the next 


read/write position 


Abnormal —1 


Explanation: The Iseek routine determines the next read/write position as an offset in bytes. 
The next read/write position is determined according to the third parameter (base) as follows: 


1. Base =0 

The second parameter gives the new offset relative to the beginning of the file. 
2. Base = 1 

The second parameter is added to the current position to give the new offset. 
3. Base =2 


The second parameter is added to the file size to give the new offset. 


An error occurs if the file is on an interactive device (such as a console or printer), the new offset 
value is negative, or the new offset value exceeds the file size in the case of 1 or 2, above. 


If Iseek correctly determines a new file position, the new offset value is returned. This value 
indicates the new read/write position relative to the beginning of the file. Otherwise, the Iseek 
routine returns a value of —1. 
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sbrk routine 





Purpose Allocates a memory area 
Interface char *sbrk ( 
unsigned long size); 

Parameters No. Name Type Meaning 

1 size unsigned long _ Size of the area to be 

allocated (in bytes) 

Return value Type Pointer to char 

Normal Start address of the allocated area 

Abnormal (char *) — 1 


Explanation: The size of the area to be allocated is given as a parameter. Create the sbrk 
routine so that consecutive calls allocate consecutive areas beginning with the lowest available 
address. An error will occur if there is insufficient memory. If the routine ends normally, it 
returns the start address of the allocated area. Otherwise, the routine returns (char *) — 1. 
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PART IV 
ERROR MESSAGES 


Section | Error Messages 


This section gives lists of error messages in order of error number. A list of error messages are 
provided for each level of errors (I = Information error, W=Warning error, E = Error, F = Fatal 
error, or (—) = Internal error) in the format below. 


Error number (Error Level: I, W, E, F, or (—)) Error Message Explanation 
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0001 (1) Character combination /* in comment 
String literal /* exists in comment. 


0002 (I) No declarator 
A declaration without a declarator exists. 


0003 (1) Unreachable statement 
A statement that will not be executed exists. 


0004 (I) Constant as condition 
A constant expression is specified as condition for if or switch statement. 


0005 (I) Precision lost 
Precision may be lost when assigning with type conversion a nght hand side value to the left hand 
side value. 


0006 (I) Conversion in argument 
A function parameter expression is converted into a parameter type specified in the prototype 
declaration. 


0008 (I) Conversion in return 
A return statement expression is converted into a value type that should be returned from a 
function. 


0010 (I) Elimination of needless expression 
A needless expression exists. 


0011 (I) Used before set symbol: “variable name” 
A variable is used before setting its value. 


0015 (I) No return value 
A return statement is not returning a value in a function that should return a type other than the 
void type, or a return statement does not exist. 


0100 (1) Function "function name" not optimized 
A function which is too large cannot be optimized. 


0200 (W) No prototype function 
There is no prototype declaration. 


1000 (W) Illegal pointer assignment 
A pointer is assigned to a pointer with a different data type. 


1001 (W) Illegal comparison in "operator" 
The operands of the binary operator == or != are a pointer and an integer other than 0. 
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1002 (W) Illegal pointer for "operator" 
The operands of the binary operator ==, !=, >, <, >=, or <= are pointers assigned to different types. 


1005 (W) Undefined escape sequence 
An undefined escape sequence (a character following a backslash) is used in a character constant or 
string literal. 


1007 (W) Long character constant 
A character constant consists of two or more characters. 


1008 (W) Identifier too long 
An identifier's length exceeds 250 characters. 


1010 (W) Character constant too long 
A character constant consists of four or more characters. 


1012 (W) Floating point constant overflow 
The value of a floating-point constant exceeds the limit. Assumes the internally represented value 
corresponding to +e or -co depending on the sign of the result. 


1013 (W) Integer constant overflow 
The value of unsigned long integer constant exceeds the limit. Assumes a value ignoring the 
overflown upper bits. 


1014 (W) Escape sequence overflow 
The value of an escape sequence indicating a bit pattern in a character constant or string literal 
exceeds 255. The low order byte is valid. 


1015 (W) Floating point constant underflow 
The absolute value of a floating-point constant is less than the lower limit. Assumes 0.0 as the 
value of the constant. 


1016 (W) Argument mismatch 

The data type assigned to a pointer specified as a formal parameter in a prototype declaration differs 
from the data type assigned to a pointer used as the corresponding actual parameter in a function 
call. Uses the internal representation of the pointer used for the function call actual parameter. 


1017 (W) Return type mismatch 

The function return type and the type in a return statement are pointers but the data types assigned 
to these pointers are different. Uses the internal representation of the pointer specified in the return 
statement expression. 


1019 (W) Illegal constant expression 
The operands of the relational operator <, >, <=, or >= in a constant expression are pointers to 
different data types. Assumes 0 as the result value. 
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1020 (W) Illegal constant expression of ''-" 
The operands of the binary operator - in a constant expression are pointers to different data types. 
Assumes 0 as the result value. 


1021 (W) Register saving pragma conflicts in interrupt function "function 
name" 

Invalid #pragma that controls saving or recovery of register contents corresponding to an interrupt 
function indicated by a function name. #pragma is ignored. 


1022 (W) First operand of operator is not Ivalue 
The first operand operator cannot be the Ivalue. 


1023 (W) Can not convert Japanese code “code” to output type 
A Japanese code “code” cannot be converted to the specified output code. 


1200 (W) Division by floating point zero 
Division by the floating-point number 0.0 is carried out in a constant expression. Assumes the 
internal representation value corresponding to +ee or -co depending on the sign of the operands. 


1201 (W) Ineffective floating point operation 

Invalid floating-point operations such as e--ce or 0.0/0.0 are carried out in a constant expression. 
Assumes the internal representation value corresponding to a not a number indicating the result of 
an ineffective operation. 


1300 (W) Command parameter specified twice 
The same SH C compiler option is specified more than once. Uses the last specified compiler 
option. 


1400 (W) Function "function name" in #pragma inline is not expanded 
A function specified using #pragma inline could not be expanded where the function is callled. 
Compiling processing continues. 


2000 (E) Illegal preprocessor keyword 
An illegal keyword is used in a preprocessor directive. 


2001 (E) legal preprocessor syntax 
There is an error in preprocessor directive or in a macro call specification. 


2002 (E) Missing "," 
A comma (,) is not used to delimit two arguments in a #define directive. 


2003 (E) Missing ")" 
A right parenthesis ( ) ) does not follow a name in a defined expression. The defined expression 
determines whether the name is defined by a #define directive. | 
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2004 (E) Missing ">" 
A right angle bracket (>) does not follow a file name in an #include directive. 


2005 (E) Cannot open include file "file name" 
The file name specified by an #include directive cannot be opened. 


2006 (E) Multiple #define's 
The same macro name is redefined by #define directives. 


2008 (E) Processor directive #elif mismatches 
There is no #if, #ifdef, #ifndef, or #elif directive corresponding to an #elif directive. 


2009 (E) Processor directive #else mismatches 
There is no #if, #ifdef, or #ifndef directive corresponding to an #else directive. 


2010 (E) Macro parameters mismatch 
The number of macro call arguments and the number of macro definition arguments are not equal. 


2011 (E) Line too long 
After macro expansion, a source program line exceeds the compiler limit. 


2012 (E) Keyword as a macro name 
A preprocessor keyword is used as a macro name in a #define or #undef directive. 


2013 (E) Processor directive #endif mismatches 
There is no #if, #ifdef, or #ifndef directive corresponding to an #endif directive. 


2014 (E) Missing #endif 
There is no #endif directive corresponding to an #if, #ifdef, or #ifndef directive, and the end of file 
is detected. 


2016 (E) Preprocessor constant expression too complex 
The total number of operators and operands in a constant expression specified by an #if or #elif 
directive exceeds the limit. 


2017 (E) Missing ” 
A closing double quotation mark (") does not follow a file name in an #include directive. 


2018 (E) Illegal #line 
The line count specified by a #line directive exceeds the limit. 


2019 (E) File name too long 
The length of a file name exceeds 128 characters. 
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2020 (E) System identifier "name" redefined 
The name of the defined symbol is the same as that of the run time routine. 


2100 (E) Multiple storage classes 
Two or more storage class specifiers are used in a declaration. 


2101 (E) Address of register 
An unary-operator & is used for a variable that has a register storage class. 


2102 (E) [legal type combination 
A combination of type specifiers is illegal. 


2103 (KE) Bad self reference structure 
A struct or union member has the same data type as its parent. 


2104 (E) Illegal bit field width 
A constant expression indicating the width of a bit field is not an integer or it is negative. 


2105 (E) Incomplete tag used in declaration 

An incomplete tag name declared with a struct or union, or an undeclared tag name is used in a 
typedef declaration or in the declaration of a data type not assigned to a pointer or to a function 
return value. 


2106 (E) Extern variable initialized 
A compound statement specifies an initial value for an extern storage class variable. 


2107 (E) Array of function 
An array with a function type is specified. 


2108 (E) Function returning array 
A function with an array return value type is specified. 


2109 (E) MHlegal function declaration 
A storage class other than extern is specified in the declaration of a function variable used in a 
compound statement. 


2110 (E) Illegal storage class 
The storage class in an external definition is specified as auto or register. 


2111 (E) Function as a member 
A member of a struct or union is declared as a function. 


2112 (E) Hlegal bit field 
A type other than an integer type is specified for a bit field. 
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2113 (E) Bit field too wide 
The width of a bit field is greater than the size (8, 16, or 32 bits) indicated by its type specifier. 


2114 (E) Multiple variable declarations 
A variable name is declared more than once tn the same scope. 


2115 (E) Multiple tag declarations 
A struct, union, or enum tag name is declared more than once in the same scope. 


2117 (E) Empty source program 
There are no external definitions in the source program. 


2118 (E) Prototype mismatch “function name” 
A function type differs from the one specified in the declaration. 


2119 (E) Not a parameter name “parameter name” 
An identifier not in the function parameter list is declared as a parameter. 


2120 (E) legal parameter storage class 
A storage class other than register is specified in a function parameter declaration. 


2121 (E) Illegal tag name 
The combination of a struct, union, or enum with tag name differs from the declared combination. 


2122 (E) Bit field width 0 
The width of a bit field specifying a member name is 0. 


2123 (E) Undefined tag name 
An undefined tag name ts specified in an enum declaration. 


2124 (E) Illegal enum value 
A non-integral constant expression is specified as a value for an enum member. 


2125 (E) Function returning function 
A function with a function type return value is specified. 


2126 (E) Illegal array size 
The value specifying the number of array elements is out of range of | to 2147483647. 


2127 (E) Missing array size 
The number of elements in an array is not specified where it is required. 


2128 (E) Illegal pointer declaration for "*"' 
A type specifier other than const or volatile is specified following an asterisk (*), which indicates a 
pointer declaration. 
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2129 (E) Illegal initializer type 
The initial value specified for a variable is not a type that can be assigned to another variable. 


2130 (KE) Initializer should be constant 
A value other than a constant expression is specified as either the initial value of a struct, union, 
or array variable or as the initial value of a static variable. 


2131 (E) No type nor storage class 
Storage class or type specifiers is not given in an external data definition. 


2132 (E) No parameter name 
A parameter is declared even though the function parameter list is empty. 


2133 (E) Multiple parameter declarations 
Either a parameter name is declared in a macro function definition parameter list more than once or 
a parameter is declared inside and outside the function declarator. 


2134 (E) Initializer for parameter 
An initial value is specified in the declaration of a parameter. 


2135 (E) Multiple initialization 
A variable is initialized more than once. 


2136 (E) Type mismatch 
An extern or static storage class variable or function is declared more than once with different data 


types. 


2137 (E) Null declaration for parameter 
An identifier is not specified in the function parameter declaration. 


2138 (E) Too many initializers 

The number of initial values specified for a struct, union, or array is greater than the number of 
struct members or array elements. This error also occurs if two or more initial values are specified 
when the first members of a union are scalar. 


2139 (E) No parameter type 
A type is not specified in a function parameter declaration. 


2140 (E) Illegal bit field 
A bit field is used in a union. 


2141 (E) Struct has no member name 
The member name of a struct is not specified. 
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2142 (E) Illegal void type 

void 1s used illegally. void can only be used in the following cases: 

1. To specify a type assigned to a pointer 

2. To specify a function return value type 

3. To explicitly specify that a function whose prototype is declared does not have a parameter 


2143 (E) Illegal static function 
There is a function declaration with a static storage class function that has no definition in the 
source program. 


2144 (E) Type mismatch 
Variables or functions with the same name which have an extern storage class are assigned to 
different data types. 


2145 (E) Const/volatile specified for imcomplete type 
An incomplete type is specified as a const or volatile type. 


2200 (E) Index not integer 
An array index expression type is not an integer. 


2201 (E) Cannot convert parameter ‘“n” 
The n-th parameter of a function call cannot be converted to the type of parameter specified in the 
prototype declaration. 


2202 (E) Number of parameters mismatch 
The number of parameters for a function call is not equal to the number of parameters specified in 
the prototype declaration. 


2203 (E) Illegal member reference for 
The expression to the left-hand side of the (.) operator is not a struct or union. 


2204 (E) Illegal member reference for "->" 
The expression to the left of the -> operator is not a pointer to a struct or union. 


2205 (E) Undefined member name 
An undeclared member name is used to reference a struct or union. 


2206 (E) Modifiable lvalue required for "operator" 
The operand for a prefix or suffix operator ++ or -- has a left value that cannot be assigned (a left 
value whose type is not array or const). 


2207 (E) Scalar required for "!"' 
The unary operator ! is used on an expression that is not scalar. 
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2208 (E) Pointer required for "*'' 
The unary operator * is used on an expression that is not pointer or on an expression of a pointer 
for void. 


2209 (E) Arithmetic type required for "operator" 
The unary operator + or - is used on a non-arithmetic expression. 


2210 (E) Integer required for "~" 
The unary operator ~ is used on a non-integral expression. 


2211 (E) Illegal sizeof 
A sizeof operator is used for a bit field member, function, void, or array with an undefined size. 


2212 (E) Illegal cast 
Either array, struct, or union is specified in a cast operator, or the operand of a cast operator is 
void, struct, or union and cannot be converted. 


2213 (E) Arithmetic type required for "operator" 
The binary operator *, /, *=, or /= is used in an expression that is not an arithmetic expression. 


2214 (E) Integer required for "operator" 
The binary operator <<, >>, &, |, “, %, <<=, >>=, &=, l=, =, or %= is used in an expression that 
is not an integer expression. 


2215 (E) Illegal type for "+" 
The combination of operand types used with the binary operator + is not allowed. 


2216 (E) legal type for parameter 
Type void is specified for a function call parameter type. 


2217 (E) Illegal type for "-"' 
The combination of operand types used with the binary operator - is not allowed. 


2218 (E) Scalar required 
The first operand of the conditional operator ?: is not a scalar. 


2219 (E) Type not compatible with "?:" 
The types of the second and third operands of the conditional operator ?: do not match with each 
other. 


2220 (E) Modifiable lvalue required for "operator" 
An expression whose left value cannot be assigned (a left value whose type is not array or const) is 
used as an operand of an assignment operator =, *=, /=, %=, +=, -=, <<=, >>=, &=, “=, or |=. 
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2221 (E) Illegal type for "operator" 
The operand of the suffix operator ++ or -- is a pointer assigned to function type, void type, or to a 
data type other than scalar type. 


2222 (E) Type not compatible for "=" 
The operand types for the assignment operator = do not match. 


2223 (E) Incomplete tag used in expression 
An incomplete tag name is used for a struct or union in an expression. 


2224 (E) Illegal type for assign 
The operand types of the assignment operator += or -= are illegal. 


2225 (E) Undeclared name “name’”’ 
An undeclared name is used in an expression. 


2226 (E) Scalar required for "operator" 
The binary operator && or Il is used in a non-scalar expression. 


2227 (E) Illegal type for equality 
The combination of operand types for the equality operator == or != is not allowed. 


2228 (E) Illegal type for comparison 
The combination of operand types for the relational operator >, <, >=, or <= is not allowed. 


2230 (E) Illegal function call 
An expression which is not a function type or a pointer assigned to a function type is used for a 
function call. 


2231 (E) Address of bit field 
The unary operator & is used on a bit field. 


2232 (E) Illegal type for "operator" 
The operand of the prefix operator ++ or -- is a pointer assigned to a function type, void type, or to 
a data type other than scalar type. 


2233 (E) Illegal array reference 
An expression used as an array is an array or a pointer assigned to a data type other than a function 
or void. 


2234 (E) Hlegal typedef name reference 
A typedef name is used as a variable in an expression. 


2235 (E) Illegal cast 
An attempt is made to cast a pointer with a floating-point type. 
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2236 (E) Illegal cast in constant 
In a constant expression, an attempt is made to cast a pointer with a char or short type. 


2237 (E) Illegal constant expression 
In a constant expression, a pointer constant is cast with an integer and the result is manipulated. 


2238 (E) Lvalue or function type required for "&" 
The unary operator & is not used on the lvalue or is used in an expression other than function 


type. 


2300 (EF) Case not in switch 
A case label is specified outside a switch statement. 


2301 (E) Default not in switch 
A default label is specified outside a switch statement. 


2302 (E) Multiple labels 
A label name is defined more than once in a function. 


2303 (E) Illegal continue 
A continue statement is specified outside a while, for, or do statement. 


2304 (E) Illegal break 
A break statement is specified outside a while, for, do, or switch statement. 


2305 (E) Void function returns value 
A return statement specifies a return value for a function with a void return type. 


2306 (E) Case label not constant 
A case label expression is not an integer constant expression. 


2307 (E) Multiple case labels 
Two or more case labels with the same value are used for one switch statement. 


2308 (E) Multiple default labels 
Two or more default labels are specified for one switch statement. 


2309 (E) No label for goto 
There is no label corresponding to the destination specified by a goto statement. 


2310 (E) Scalar required 
The control expression (that determines statement execution) for a while, for, or do statement is 
not a scalar. 
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2311 (E) Integer required 
The control expression (that determines statement execution) for a switch statement is not an 
integer. 


2312 (E) Missing ( 
The control expression (that determines statement execution) does not follow a lett parenthesis ( ( ) 
for an if, while, for, do, or switch statement. 


2313 (E) Missing ; 
A do statement is ended without a semicolon (;). 


2314 (FE) Scalar required 
A control expression (that determines statement execution) for an if statement is not a scalar. 


2316 (E) legal type for return value 
An expression in a return statement cannot be converted to the type of value expected to be 
returned by the function. 


2400 (E) Illegal character "character" 
An illegal character is detected. 


2401 (E) Incomplete character constant 
An end of line indicator is detected in the middle of a character constant. 


2402 (E) Incomplete string 
An end of line indicator is detected in the middle of a string literal. 


2403 (E) EOF in comment 
An end of file indicator is detected in the middle of a comment. 


2404 (E) Illegal character code "character code" 
An illegal character code is detected. 


2405 (E) Null character constant 
There are no characters in a character constant (i.e., no characters are specified between two 
quotation marks). 


2406 (E) Out of float 
The number of significant digits in a floating-point constant exceeds 17. 


2407 (E) Incomplete logical line | 
A backslash (\) or a backslash followed by an end of line indicator (\ (RET) ) is specified as the last 
character in a non-empty source file. 
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2408 (E) Comment nest too deep 
The nesting level of the comment exceeds the limit of 255 level. 


2500 (E) Illegal token “phrase” 
An illegal token sequence is used. 


2501 (E) Division by zero 
An integer is divided by zero in a constant expression. 


2600 (E) String literal(s) 
An error message specified by string literal #error is output to the list file if nolist option is not 
specified. 


2650 (E) Invalid pointer reference 
The specified address does not match the boundary alignment value. 


2700 (E£) Function "function name" in #pragma interrupt already declared 
A function specified in an interrupt function declaration #pragma interrupt has been declared as a 
normal function. 


2701 (E) Multiple interrupt for one function 
An interrupt function declaration #pragma interrupt has been declared more than once for the same 
function. 


2702 (E) Multiple #pragma interrupt options 
The same type of interrupt is declared more than once. 


2703 (E) Illegal #pragma interrupt declaration 
An interrupt function declaration #pragma interrupt is specified incorrectly. 


2704 (E) Illegal reference to interrupt function 
The interrupt function is referenced incorrectly. 


2705 (E) Illegal parameter in interrupt function 
Argument types to be used for an interrupt function do not match. 


2706 (E) Missing parameter declaration in interrupt function 
There is no declaration for a variable to be used for an optional specification of an interrupt 
function. 


2707 (E) Parameter out of range in interrupt function 
The parameter value tn of an interrupt function exceeds the limit of 256. 


2709 (E) Illegal section name declaration 
The #pragma section specification 1s illegal. 
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2710 (E) Section name too long 
The specified section name exceeds the limit of 31 characters. 


2711 (EF) Section name table overflow 
The number of section specified in one file exceeds the limit of 64. 


2712 (FE) GBR based displacement overflow 
The variable declared in #pragma gbr_base overflows. 


2713 (E) Illegal #pragma interrupt function type 
The function type specified #pragma interrupt in illegal. 


2800 (E) Illegal parameter number in in-line function 
Parameters to be used for an intrinsic function do not match. 


2801 (EK) Illegal parameter type in in-line function 
There are different parameter types in an intrinsic function. 


2802 (E) Parameter out of range in in-line function 
A parameter exceeds the range that can be specified by an intrinsic function. 


2803 (E) Invalid offset value in in-line function 
An argument for an intrinsic function 1s specified incorrectly. 


2804 (E) Illegal in-line function 
An intrinsic function that cannot be used by the specified cpu option exists. 


2805 (E) Function "function name" in #pragma inline/inline_asm already 
declared 
The function indicated by a function name exists before the #pragma specification. 


2806 (E) Multiple #pragma for one function 
Two or more #pragma directives are specified for one function incorrectly. 


2807 (E) [legal #pragma inline/inline_asm declaration 
The #pragma inline or #pragma inline_asm is specified illegally. 


2808 (E) Illegal option for #pragma inline_asm 
The -code=machinecode option is specified in addition to the #pragma inline_asm specification 
declaration. 


2809 (E) INegal option for #pragma inline/inline_asm function type 
An identifier type that specifies #pragma inline or #pragma inline_asm is illegal. 
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2810 (E) Global variable “variable name” in #pragma gbr_base/gbr_basel 
already declared 
A variable definition indicated by variable name exists before #pragma specification. 


2811 (E) Multiple #pragma for one global variable 
Two or more #pragma directives are specified for one variable incorrectly. 


2812 (E) Illegal #pragma gbr_base/gbr_basel declaration 
The #pragma gbr_base or #pragma gbr_basel specification is illegal declaration. 


2813 (E) Illegal #pragma gbr_base/gbr_basel global variable type 
An identifier type that specifies #pragma gbr_bsee or #pragma gbr_base1 is illegal. 


2814 (E) Function “function name” in #pragma noregsave/norealloc/regsave 
already declared 
The function indicated by a function name exists before the #pragma specification declaration. 


2815 (E) INegal #pragma noregsave/noregalloc/regsave declaration 
The #pragma noregsave, or #pragma noregalloc, or #pragma regsave specification is illegal. 


2816 (E) Illegal #pragma noregsave/noregalloc/regsave function type 
An identifier type that specifies #pragma noregsave, #pragma noregalloc, or #pragma regsave is 
illegal. 


2817 (E) Symbol "identifier" in #pragma abs16 already declared 
A name indicated by an identifier exists before the #pragma specification declaration. 


2818 (E) Multiple #pragma for one symbol 
More than one #pragma is incorrectly specified for one identifier. 


2819 (E) Illegal #pragma absl6 declaration 
The #pragma abs16 specification is illegal declaration. 


2820 (E) Illegal #pragma abs16 symbol type 
An identifier type that specifies #pragma abs 16 is illegal. 


2821 (E) Global variable “variable name” in #pragma global_register already 
declared 
The variable that specifies #pragma global_register has already been specified. 


2822 (E) Illegal register “register” in #pragma global_register 
The register that specified #pragma global_register is illegal. 


2823 (E) Illegal #pragma global_register declaration 
The specification method of #pragma global_register is illegal. 
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2824 (E) INegal #pragma global_register type 
A variable that cannot specify #pragma global_register exists. 


3000 (F) Statement nest too deep 
The nesting level of an if, while, for, do, and switch statements exceeds the limit. The maximum 
number is 32 levels. 


3001 (F) Block nest too deep 
The nesting level of compound statements exceeds the limit. The maximum number is 32 levels. 


3002 (F) #if nest too deep 
The conditional compilation (#f, #ifdef, #ifndef, #elif, and #else) nesting level exceeds the limit. 
The maximum number is 32 levels. 


3006 (F) Too many parameters 
The number of parameters in either a function declaration or a function call exceeds the limit. The 
maximum number is 63. 


3007 (F) Too many macro parameters 
The number of parameters in a macro definition or a macro call exceeds the limit. The maximum 
number is 63. 


3008 (F) Line too long 
After a macro expansion, the length of a line exceeds the limit. The maximum number is 4096 
characters. 


3009 (F) String literal too long 

The length of string literal exceeds 512 characters. The length of string literal equals to the 
number of bytes when linking string literals specified continuously. The length of the string 
literal is not the length in the source program but the number of bytes included in the string literal 
data. Escape sequence is counted as one character. 


3010 (F) Processor directive #include nest too deep 
The nesting level of the #include directive exceeds the limit. The maximum level is 30. 


3011 (F) Macro expansion nest too deep 
The nesting level of macro expansion performed by a #define directive exceeds the limit. 
The maximum level 1s 32. 


3012 (F) Too many function definitions 
The number of function definitions exceeds the limit. The maximum number is 512. 


3013 (F) Too many switches 
The number of switch statements exceeds the limit. The maximum number is 256. 
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3014 (F) For nest too deep 
The nesting level of a for statement exceeds the limit. The maximum level is 16. 


3015 (F) Symbol table overflow 
The number of symbols to be generated by the SH C compiler exceeds the limit. The maximum 
number is 24576. 


3016 (F) Internal label overflow 
The number of internal labels to be generated by the SH C compiler exceeds the limit. The 
maximum number is 32767. 


3017 (F) Too many case labels 
The number of case labels in one switch statement exceeds the limit. The maximum number is 
511. 


3018 (F) Too many goto labels 
The number of goto labels defined in one function exceeds the limit. The maximum number 1s 
511. 


3019 (F) Cannot open source file "file name" 
A source file cannot be opened. 


3020 (F) Source file input error "file name" 
A source or include file cannot be read. 


3021 (F) Memory overflow 
The SH C compiler cannot allocate sufficient memory to compile the program. 


3022 (F) Switch nest too deep 
The nesting level of a switch statement exceeds the limit. The maximum level is 16. 


3023 (F) Type nest too deep 
The number of types (pointer, array, and function) that qualify the basic type exceeds 16. 


3024 (F) Array dimension too deep 
An array has more than six dimensions. 


3025 (F) Source file not found 
A source file name is not specified in the command line. 


3026 (F) Expression too complex 
An expression is too complex. 


3027 (F) Source file too complex 
The nesting level of statements in the program is too deep or an expression is too complex. 
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3028 (F) Source line number overflow 
The last source line number exceeds the limit. The maximum number is 65535. 


3030 (F) Too many compound statements 
The number of compound-statements exceeds the limit. 


3031 (F) Data size overflow 
The size of an array or a structure exceeds the limit of 2147483647 bytes. 


3033 (F) Symbol table overflow 
The number of symbols used for debugging information exceeds 32767. 


3100 (F) Misaligned pointer access 
There has been an attempt to refer or specify using a pointer that has an invalid alignment. 


3201 (F) Object size overflow 
The object file size exceeds the limit of 4 Gbytes. 


3202 (F) Too many source lines for debug 
There are too many source line to output debugging information. 


3203 (F) Assembly source line too long 
The assembly source line is too long to output. 


3204 (F) Illegal stack access 

The size of a stack to be used in a function (including a local variable area, register save area, and 
parameter push area to call other functions) or a parameter area to call the function exceeds 

2 Gbytes. 


3300 (F) Cannot open internal file 

An error occurred due to one of the following causes: 

(1) An intermediate file internally generated by the SH C compiler cannot be opened. 

(2) A file that has the same file name as the intermediate file already exists. 

(3) The number of characters in a path name for a list file specification exceeds the limit of 
128 characters. 

(4) A file which the SH C compiler uses internally cannot be opened. 


3301 (F) Cannot close internal file 
An intermediate file internally generated by the SH C compiler cannot be closed. Make sure the 
SH C compiler is installed correctly. 


3302 (F) Cannot input internal file 
An intermediate file internally generated by the SH C compiler cannot be read. Make sure the SH 
C compiler is installed correctly. 
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3303 (F) Cannot output internal file 
An intermediate file internally generated by the SH C compiler cannot be written. 


3304 (F) Cannot delete internal file 
An intermediate file internally generated by the SH C compiler cannot be deleted. 


3305 (F) Invalid command parameter "option name" 
An invalid compiler option is specified. 


3306 (F) Interrupt in compilation 
An interrupt generated by a (CNTL) C command (from a standard input terminal) is detected during 
compilation. 


3307 (F) Compiler version mismatch 
File versions specified in the SH C compiler do not match the other file versions. 


3320 (F) Command parameter buffer overflow 
The command line specification exceeds 256 characters. 


3321 (F) IHegal environment variable 
An error occurred due to one of the following causes: 


1. SHC_LIB was not specified. 


2. A file name was specified incorrectly when SHC_LIB was specified or the number of characters 
in a path name exceeds the limit of 118 characters. 


3. Other than SH1, SH2, SHDSP, SH3, or SH3E is set for the environment variable SHCPU. 


4000 - 4999 (—) Internal error 
An internal error occurs during compilation. Report the error occurrence to your local Hitachi 
dealer. 
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Section 2 C Standard Library Error Messages 


For some library functions, if an error is generated during the library function execution, an error 
number is set in the macro errno defined in the header file <errno.h> contained in the standard 
library. Error messages are defined in the error numbers so that error messages can be output. The 
following shows an example of an error message output program. 


Example: 
#include <stdio.h> 
#include <string.h> 
#include <stdlib.h> 
main () 
{ 
FILE *fp; 


fp=fopen(“file”, “w”); 


fp=NULL; 
fclose(fp) ; /* error occurred */ 
printf(*%s\n”, strerror(errno) ); /* print error message ia | 
} 
Description: 


1. Since the file pointer of NULL is passed to the fclose function as an actual parameter, an error 
will occur. In this case, an error number corresponding to errno Is set. 

2. The strerror function returns a pointer of the string literal of the corresponding error message 
when the error number is passed as an actual parameter. An error message is output by 
specifying the output of the string literal of the printf function. 
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Table 4.1 List of Standard Library Error Messages 


Functions to 





Error No. Error Message/Explanation Set Error Numbers 
1100 Data out of range atan, cos, sin, tan, cosh, sinh, tanh, 
(ERANGE) An overflow occured. exp, fabs, frexp, Idexp, modf, ceil, 
floor, strtol, atoi, fscanf, scanf, 
sscanf, atol 
1101 Data out of domain acos, asin, atan2, log, log10, sart, 
(EDOM) Results for mathematical fmod, pow 
parameters are not defined. 
1102 Division by zero divbs, divws, divlis, divbu, divwu, 
(EDIV) Division by zero was performed. diviu 
1104 Too long string strtol, strtod, atof, atoi, atol 
(ESTRN) The length of string literal exceeds 
512 characters. 
1106 Invalid file pointer fclose, fflush, freopen, setbuf, 
(PTRERR) NULL pointer constant is specified setvbuf, fprintf, fscanf, printf, 
| as the file pointer value scanf, sprintf, sscanf, vfprintf, 
vprintf, vsprintf, fgetc, fgets, fputc, 
fputs, ungetc, fread, fwrite, fseek, 
ftell, rewind, perror 
1200 Invalid radix Strtol, atol, atoi 
(ECBASE) An invalid radix was specified. 
1202 Number too long strtod, fscanf, scanf, sscanf, atof 
(ETLN) The specified number exceeds 17 | 
digits. 
1204 Exponent too large strtod, fscanf, scanf, sscanf, atof 
(EEXP) The specified exponent exceeds 3 
digits. 
1206 Normalized exponent too large __ strtod, fscanf, sscanf, atof 
(EEXPN) The exponent exceeds three digits 
when the string literal is normalized 
to the IEEE standard decimal 
format. 
1210 Overflow out of float strtod, fscanf, scanf, sscanf, atof 
(EFLOATO) A float-type decimal value is out of 
range (overflow). 
1220 Underflow out of float strtod, fscanf, scanf, sscanf, atof 
(EFLOATU) A float-type decimal value is out of 
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range (underflow). 


Table 4.1 List of Standard Library Error Messages (cont) 


Error No. 


1250 
(EDBLO) 


1260 
(EDBLU) 


1270 
(ELDBLO) 


1280 
(ELDBLU) 


1300 
(NOTOPN) 


1302 
(EBADF) 


1304 
‘(ECSPEC) 


Error Message/Explanation 


Overflow out of double 
A double-type decimal value is out 
of range (overflow). 


Underflow out of double 
A double-type decimal value is out 
of range (underflow). 


Overflow out of long double 
A long double-type decimal value is 
out of range (overflow). 


Underflow out of long double 
A long double-type decimal value is 
out of range (underflow). 


File not open 
The file is not open. 


Bad file number 

An output function was issued for 
an input file, input file was issued for 
an output function. 


Error in format 

An erroneous format was specified 
for an input/output function using 
format. 


Functions to 
Set Error Numbers 


strtod, fscanf, scanf, sscanf, atof 


strtod, fscanf, scanf, sscanf, atof 


fscanf, scanf, fscanf 


fscanf, scanf, sscanf 


fclose, fflush, setbuf, setvbuf, 
fprintf, fscanf, printf, scanf, sprintf, 
sscanf, vfprintf, vprintf, vsprintf, 
fgetc, fgets, fputc, fputs, gets, puts, 
ungetc, fread, fwrite, fseek, ftell, 
rewind, perror, freopen 


fprintf, fscanf, printf, scanf, sprintf, 
sscanf, vfprintf, vprintf, vsprintt, 
fgetc, fgets, fputc, fputs, gets, puts, 
ungetc, perror, fread, fwrite 


fprintf, fscanf, printf, scanf, sprintf, 
sscanf, vfprintf, vprintf, vsprintt, 
perror 
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APPENDIX 


Appendix A Language and Standard Library Function 
Specifications of the C Compiler 


A.1 WLanguage Specifications of the C Compiler 


A.1.1 Compilation Specifications 


Table A.1 Compilation Specifications 


Item C Compiler Specification 


Error information when an error is detected Refer to part IV, Error Messages 


A.1.2 Environmental Specifications 


Table A.2 Environmental Specifications 


Item C Compiler Specification 
Actual argument for the main function Not specified 
Interactive I/O device configuration Not specified 
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A.1.3 Identifiers 


Table A.3 Identifier Specifications 


Item C Compiler Specification 


Number of valid characters of internal identifiers not The first 250 characters are valid for an 
used for external linkage internal or external identifier. 


Number of valid characters of external identifiers 
used for external linkage 


Lowercase and uppercase character distinction in Lowercase characters are distinguished 
external identifiers used for external linkage from uppercase characters. 


Note: Two different identifiers with the same first 250 characters are considered to be identical 
even if the 251st or later characters are different. 


Example: 
1. longabcde ... ab; (the 250th character is a and the 251st character is b) 


2. longabcde ... ac; (the 250th character is a and the 251st character is c) 
Identifiers1. and 2. are indistinguishable because the first 250 characters are the same. 
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A.1.4 Characters 


Table A.4 Character Specifications 


Item 


Elements of source character set and execution 
environment character set 


Shift state used for encoding multiple-byte 
characters 


The number of bits used to indicate a character set 
during program execution 


Correspondence between source character set used 
in character constant or character string and 
execution environment character set 


Value of character constant including characters and 
escape sequence that are not specified in the C 
language 


Character constant of two or more characters or wide 
character constant including multiple-byte characters 
of two or more characters 


locale specifications used to convert mune. byte 
character to wide character 


Simple char having normal the value range same as 
signed char or unsigned char. 


C Compiler Specification 
ASCII character set 





Kanji used in host environment can be 
used for source program comment. 


Shift state is not supported 
Eight bits are used for each character. 


ASCII is used for both. 


Characters and escape sequence other 
than that specified by the C language are 
not supported. 


The upper one character of the character 
constant is valid. Wide character 
constant is not valid. If a character 
constant of more than one character is 
specified, a warming error message is 
output. 


locale is not supported 


The same range as the signed char. 
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A.1.5 Integer 


Table A.5 Integer Specifications 


item C Compiler Specification 


Integer-type data representation and value Table A.6 shows data representation and 
value. (A negative value is shown in two's 
complement.) 


Effect when an integer is too large to be converted The lower one or two bytes of the integer is 
into a signed integer-type value or into a value used as the conversion result. 


which cannot be expressed using signed char type 
(when the resulting value cannot be represented with 
the resulting converted type) 


The result of bitwise operations on signed integers signed value 


Sign of the remainder for integer division Same as the sign of the dividend. 
Effect of a right shift operation on the sign bit of The sign bit is unchanged by the shift 
signed integer-type data operation. 


Table A.6 Integer Types and Their Corresponding Data Range 


Type Range of Values Data Size 


char (signed char) —128 to 127 1 byte 

unsigned char 0 to 255 1 byte 

short ~32768 to 32767 2 bytes 
unsigned short 0 to 65535 2 bytes 
int —2147483648 to 2147483647 4 bytes 
unsigned int | 0 to 4294967295 4 bytes 
long —2147483648 to 2147483647 4 bytes 
unsigned long 0 to 4294967295 4 bytes 
Note: Type specification in parenthesis () can be omitted. The order of type specification is 

arbitrary. 
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A.1.6 Floating-Point Numbers 


Table A.7 Floating-Point Number Specifications 


Item 


Data that be represented as floating-point type 


and value 


Rounding down direction when converting an integer 
number to a floating-point number that cannot 
represent the integer's original value correctly 


Rounding down or rounding method when converting 
a floating-point number to a lower-precision number 


C Compiler Specification 


The float, double, and long double are 


provided as floating-point types. 


See section A.3, Floating-Point Number 
Specifications, for details on floating-point 
numbers (internal representation, 


conversion specifications, and operation 
specifications). Table A.8 shows the limits 


on representing floating-point numbers. 


Table A.8 Limits on Floating-Point Numbers 


item 


Maximum value of float type 


Positive minimum value of 
float type 


Maximum value of double” 
or long double type 


Positive minimum value of 
double? or long double 


type 


Decimal’ 


3.4028235677973364e+38f 
(3.4028234663852886e+38f) 


7.0064923216240862e—46f 
(1.4012984643248171e-45f) 


1.7976931348623158e+308 
(1.7976931348623157¢e+308) 


4.9406564584124655e-324 
(4.9406564584124654e-324) 


Hexadecimal 
TEPFEELEE 


00000001 


TfefffLfFLfLfTLEFCL£ee 


0000000000000001 


Notes: 1. Limits on decimal is non-zero minimum value or maximum value not infinitive 
value. Values within ( ) indicate theoretical values. 
2. double type will have the same value as float type when —double=float 


option is specified. 
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A.1.7 Arrays and Pointers 


Table A.9 Array and Pointer Specifications 


Item 


Integer type required for holding array's maximum 
size (size_t) 


Conversion from pointer-type data to integer-type 
data (Pointer-type data size 2 Integer-type data 
size) 


Conversion from pointer-type data to integer-type 
data (Pointer-type data size < Integer-type data 
size) 


Conversion from integer-type data to pointer-type 
data (Integer-type data size > Pointer-type data 
size) 


Conversion from integer-type data to pointer-type 
data (Integer-type data size < Pointer-type data 
size) 


Integer type required for holding pointer difference 


between members in the same array (ptrdiff_t) 


A.1.8 Register 


Table A.10 Register Specifications 


Item 


The maximum number of register vanenie® that can 


be allocated to registers 


Type of register variables that can be allocated to 
registers 


164 HITACHI 


C Compiler Specification 





unsigned long 


The lower byte of pointer-type data is used. 
Extended with signs 
The lower byte of integer-type data is used. 


Extended with signs 


int 


C Compiler Specification 
= : — 


char, unsigned char, short, 
unsigned short, int, unsigned int, 
long, unsigned long, float, and 
pointers 





A.1.9 Structure, Union, Enumeration, and Bit Field Types 


Table A.11 
Types 


Item 


Effect of referencing a union-type member using 
another member whose data type is different 


Structure member alignment 


Sign of an int bit field 


Allocation order of bit fields in int area 


Result when a bit field has been allocated in an int 
area and the next bit field to be allocated is larger 
than the remaining int 


Type specifier allowed for bit field 


Integer describing enumeration 


Specifications for Structure, Union, Enumeration, and Bit Field 


C Compiler Specification 


Reference is possible but the referred value 
is not guaranteed. 


The maximum data size among structure 
members is a boundary alignment number. 
Refer to table A.6 Integer Types and Their 
Corresponding Data Range. *! 


Assumed to be signed int 


Beginning from the high order bit to low 
order bit. ** 


The next bit field is allocated to the next int 
area.*? 


char, unsigned char, short, 
unsigned short, int, unsigned int, 
long, and unsigned long 


int 


Notes: 1. See section 2.2.2 Combined-Type Data, in part Il C Programming, for details on 


structure member allocation. 


2. See section 2.2.3, Bit Fields, in part Il C Programming, for details on bit field allocation. 


A.1.10 Qualifier 


Table A.12 Qualifier Specifications 


Item 


volatile data access type 


C Compiler Specification 


Not specified 
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A.1.11 Declarations 


Table A.13. Declaration Specifications 


Item C Compiler Specification 


Types that can qualify the basic types Up to 16 types can be specified. 
(pointer, array, and function) 


1. Example of counting the number of types that qualify the basic types 


Examples: 
a. int a; 
ais int (basic type) and the number of declarators that qualify the basic type is zero. 
b. char *f(); 
f is a function type that returns pointer to char (basic type). The number of declarators 
that qualify the basic type is two. 


A.1.12 Statement 


Table A.14 Statement Specifications 


Item C Compiler Specification 


The number of case label that can be declared ina Up to 511 labels can be specified. 
switch statement 
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A.1.13 Preprocessor 


Table A.15 Preprocessor Specifications 


item 


in a constant expression and execution environment 
character set in the conditional compilation 


Reading an include file 


Supporting an include file whose name is enclosed in 
a pair of double quotation marks 


Blank character in the character string of an actual 
parameter for a #define statement after expansion 


#pragma directive operation 


TIME_ 


we ee) me me — 


Value of __ DATE 





Correspondence between single character constant - Character strings in the preprocessor 


C Compiler Specification 


statement match the execution 
environment character set 


The file within < > is read from a directory 
specified by the include option. When 
more than one directory is specified, a file is 
searched for in the specified order. lf a 
specified file is not found at a specified 
directory, the search continues at a 
directory specified by environment variable 
SHC_INC and a system directory 
(SHC_LIB) in this order. 


The C compiler supports include files whose 
names are delimited by double quotation 
marks. The C compiler reads these include 
files from the current directory. If the 
include files are not in the current directory, 
the C compiler reads them from the 
directory specified in advance. 


Strings of blanks are expanded as one 
blank character. 


#pragma interrupt, #pragma section, 
#pragma inline, #pragma inline_asm, 
#pragma abs16, #pragma gbr_base, 
#pragma gbr_base1, #pragma noregsave, 
#pragma noregalloc, #pragma regsave, and 
#pragma global_register are supported.”' 


Data depending on the host machine timer 
when the compilation starts. 


Note: See section 3, Extended Specification, in part Il C Programming, for details on #pragma 


specifications. 
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A.2 C Library Function Specifications 


This section explains the specifications for C library functions that are not declared in C language 
specification. 


A.2.1 stddef.h 


Table A.16 = stddef.h Specifications 


Item C Compiler Specification 

Value of macro NULL The value is 0 for a pointer type to a void 
type 

Contents of ptrdiff_t int type 


A.2.2 assert.h 


Table A.17 = assert.h Specifications 


Item C Compiler Specification 

Information output and terminal operation of assert See 1. for the format of output information. 

function The program outputs information and then 
calls the abort function to stop the 
operation. 


1. The following message is output when the value of the expression is O for assert (expression): 
Assertion Failed: A<expression>AFileA<file name>, LineA<line number> 


A.2.3  ctype.h 


Table A.18 ctype.h Specifications 


Item | C Compiler Specification 


The character set for which the isalnum, isalpha, Character set that can be expressed in 

iscntrl, islower, isprint, and isupper functions unsigned char type. Table A.19 shows 

check the character set that results in a true 
return value. 
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Table A.19 Set of Characters that Returns True 





Function Name Characters That Become True 
isalnum 'O' to '9', ‘A’ to 'Z', ‘a’ to 'z' 

isalpha ‘A t0"Z', ‘a to-2' 

isentrl '€X00' to “¥X1f, “¥X7F : 
islower ‘a’ to'z' 

isprint '¥X20' to '¥X7E' 

isupper ‘A’ to 'Z' 





A.2.4 math.h 


Table A.20 £math.h Specifications 


Item C Compiler Specification 


Value returned by a mathematical function if an input For details on format for not a number, refer 
parameter is out of the range to A.3, Floating-Point Number 
Specifications 
Returns a not a number. 


Is errno set to the value of macro ERANGE if an No, it is not. 
underflow error occurs in a mathematical function? 


Does a range error occur if the 2nd actual parameter Returns a not a number and a range error 
in the fmod function is 0 occurs. 


Note: math.h defines macro names ENUM and ERANGE that indicates a standard library error 
number. 


A.2.5  setjmp.h 


Table A.21  setjmp.h Specifications 


Item C Compiler Specification 


What programs can a setjmp function be called in? The following statements can call a setjmp 
function if specified with setjmp() or 
ver=setjmp() format: 


1. A-single statement or an if, while, do, 
or for statement that specifies 
condition 

2. switch or return statement 
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A.2.6 stdio.h 


Table A.22 = stdio.h Specifications 


Item 


Is a carriage return character indicating the last line 
of input data required? 


ls a blank character immediately before the carriage 


return character read? 


Number of NULL characters added to data written to 


binary file 


Initial value of file position specifier in addition mode 


ls a file data lost following text file output? 

File buffering specifications 

Does a file with file length 0 exist? 

File name configuration rule 

Can the same files be opened simultaneously? 


Output data representation of the %p format 
conversion in the fprintf function 


Output data representation of the %p format 
conversion in the fscanf function, the meaning of 
(—) in the fscanf function 


Value of errno specified by fgetpos and ftell 
functions 


Output format of messages generated by the 
perror function 


calloc, malloc, or realloc function operation 
when the size is 0 


C Compiler Specification 


Not specified. Depends on the low-level 
interface routine specifications. 


Hexadecimal representation 


Hexadecimal representation 

If (—) is not placed at the beginning or end of 
a fscanf character string or does not 
follow (4) in a fscanf character string, 
indicates the range between the previous 
and following characters. 


The fgetpos function is not supported. 
The ftell function does not specify the 
errno value. The ermo value is determined 
depending on the low-level interface 
routine. 


See 1. below for the output message 
format. 


0 byte area is allocated. 


1. Messages generated by a perror function follow this format: 


<character string> : <error message corresponding to the error number indicated by errno> 


2. Table A.23 shows the format used to indicate infinity and not a number for floating-point 
numbers when using the printf or fprintf function. 
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Table A.23 Infinity and Not a number 


Value C Compiler Specification 


Positive infinity owes 
Negative infinity 4 42 ee 


Not a number tee Wk % 


A.2.7  string.h 


Table A.24 © string.h Specifications 


Item 


Return value from an memcmp, strcmp, or 
strncmp function. 


Error message returned by the strerror function 


C Compiler Specification 


Value is treated as a signed value. 


Refer to section 2, C Standard Library, in 
part IV Error Messages. 
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A.2.8  errno.h 


Table A.25 ~— errno.h Specifications 


Item C Compiler Specification 


errno An error number is specified when an error occurs in an int 
type variable or a library function. 


ERANGE Refer to section 2, C Standard Library Error Messages, in part 
IV Error Messages. . 


EDOM 
EDIV 
ESTRN 
PTRERR 
ECBASE 
ETLN 
EEXP 
EEXPN 
EFLOATO 
EFLOATU 
EDBLO 
EDBLU 
ELDBLO 
ELDBLU 
NOTOPN 
EBADF 
ECSPEC 
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A.2.9 Libraries that are Not Supported by the SH C Compiler 


Table A.26 shows a list of libraries that are not supported by the SH C compiler but are defined in 
the H series C language manual specification. Header files are not supported for signal.h and 


time.h. 
Table A.26 


Header File 
signal.h 
stdio.h 
stdlib.h 


time.h 


Libraries that are Not Supported by the SH C Compiler 


Library 

Signal, raise 

remove, rename, tmpfile, tmpnam 
getenv, system 


clock, difftime, time, asctime, ctime, gmtime, 
localtime 
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A.3 Floating-Point Number Specifications 
A.3.1 Internal Representation of Floating-Point Numbers 


The internal representation of floating-point numbers follows the IEEE standard format. This 
section explains the outline of the internal representation of IEEE-type floating-point numbers. 


Internal Representation Format: float is represented in IEEE single precision (32 bits), 
double and long double are represented in IEEE double precision (64 bits). 


Internal Representation Structure: Figure A.1 shows the structure of float, double, and 
long double in internal representation. 


Sign Exponent Mantissa 
(1 bit) (8 bits) (23 bits) 


double’! and long double 
63 62 52 51 


Sign Exponent Mantissa 
(1 bit) (11 bits) (52 bits) 


Note: When —double = float option is specified, double type and float type have the same internal 
representation. 





Figure A.1l Structure for the Internal Representation of Floating-Point 
Numbers 


The elements of the structure have the following meanings. 


1. Sign 


This indicates the sign of a floating-point number. Positive and negative are represented by 0 
and 1, respectively. 


2. Exponent 
This indicates the exponent of a floating-point number as a power of two. 
3. Mantissa 


This determines the significant digits of a floating-point number. 
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Types of Values: Floating-point numbers can represent infinity in addition to real numbers. 
The rest of this section explains the types of values that can be represented by floating-point 
numbers. 


1. Normalized Number 
The exponent is not 0 or the maximum. A normalized number represents a real number. 
2. Denormalized Number 


The exponent is 0 and the mantissa is not 0. A denormalized number ts a real number whose 
absolute value is very small. 


3. Zero 

The exponent and mantissa are both 0. Zero represents the value 0.0. 
4. Infinity 

The exponent is the maximum and mantissa Is 0. 
5. Nota Number 


The exponent is the maximum and the mantissa is not 0. This is used to represent an 
operation result that is undefined (such as 0.0/0.0, o0/c0, oo — 00), 


Note: A denormalized number represents a floating-point number whose absolute value is so 
small that it cannot be represented as a normalized number. Denormalized numbers have 
less significant digits than normalized numbers. The significant digits of a result are not 
guaranteed if either the operation result or an intermediate result is a denormalized number. 


Table A.27 Types of Values Represented by Floating-Point Numbers 


Exponent 
Mantissa 0 Other than O or Maximum Maximum 
0 0 Normalized number Infinity 
Other than 0 Denormalized number Not a number 
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A.3.2 float 


float is internally represented as 1 sign bit, 8 exponent bits, and 23 mantissa bits. 


Normalized Number: The sign bit is either 0 (positive) or 1 (negative). The exponent is a 


number from 1 to 254 (28-2). From the value 1 to 254, 127 is subtracted and the result is used 
as the actual exponent. The range of actual exponents is -126 to 127. The mantissa is a value 


from 0 to 2% - 1. The actual mantissa is assumed that the highest order bit (2°) is 1 and a 
decimal point follows it. 


Value represented by a normalized number is shown in the following expression: 


(—1)<Sign> x 2<exponent> -127 y (14 <mantissa> x 2°) 


Example: 
31 30 23 22 Q 
Sign: _ 

Exponent: 10000000, —-127=1 
Mantissa: = 1.11) = 1.75 

Value: -1.75 x 2' =-3.5 


((2) indicates binary data throughout this manual.) 


Denormalized Number: The sign bit is either 0 (positive) or 1 (negative). The exponent is 0 
which makes the actual exponent equal to -126. The mantissa is a value from 1 to 2” — 1. The 
actual mantissa is assumed that a highest order bit (2”) is 0 and a decimal point follows it. 


Value represented by a denormalized number is shown in the following expression: 


(-1)<Sign> x 2<exponent> -126 x ( <mantissa> x 27) 


Example: 

31 30 23 22 0 
00 0000000|11000000000000000000000 
Sign: + 

Exponent: 0, —-126 =-—126 


Mantissa: 0.11... =0.75 
Value: 0.75 x 2" 
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Zero: The sign bit ts either 0 (positive) or 1 (negative) and indicates +0.0 and -0.0, respectively. 
The exponent and mantissa are 0. Both +0.0 and -0.0 represent 0.0. See appendix A.3.4, 
Floating-Point Operation Specifications, for differences in each operation depending on the sign. 


Infinity: The sign bit is either 0 (positive) or | (negative) and indicates +o and —o, 
respectively. The exponent is 255 (2° — 1). The mantissa is 0. 


Not a Number: The exponent is 255 (2° — 1) and the mantissa is not equal to 0. 


Note: When the CPU is SH3E, the not a number for the most significant bit of the mantissa 
which is 0 is called qNaWN, and the not a number for the most significant bit of the 
mantissa which is | is called sNaN. Other mantissa field values and sign parts are not 
specified. 


A.3.3. double and long double 


A double or long double is represented as | sign bit, 11 exponent bits, and 52 mantissa bits. 


Normalized Number: The sign bit is either 0 (positive) or 1 (negative). The exponent is a 
number from 1 to 2046 (2'' — 2). From the value | to 2046, 1023 is subtracted and the result is 
used as the actual exponent. The range of actual exponents is —-1022 to 1023. The mantissa is a 
value from 0 to 2° — 1. The actual mantissa is assumed that the highest order bit (2°*) is 1 and a 
decimal point follows it. 


Value represented by a normalized number is shown in the following expression: 


(—1)<Sign> x 2<exponent> -1023 x (1 4 <mantissa> x 2°) 


Example: 
63 92 51 ) 
oloi231211113h110000000000000000000000000000000000000000000000000 
Sign: + 
Exponent: IJ111111111Q)— 1023=1 
Mantissa: 1.111) = 1.875 
Value: 1.875 x 2° = 1.875 
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Denormalized Number: The sign bit is either 0 (positive) or 1 (negative). The exponent is 0 
which makes the actual exponent equal to -1022. The mantissa value is from 1 to 2*-—1. The 
actual mantissa is assumed that the highest order bit (2°”) is 0 and a decimal point follows it. 


Value represented by a denormalized number is shown in the following expression: 
(~1)*S1gN> x 2<exponent> -1022 yx (<mantissa> x 2”) 


Example: 
63 92 51 0 
oo.90000000001210000000000000000000000000000000000000000000000000 
Sign: | ~ 
Exponent: 0) -1022 = -1022 
Mantissa: 0.111Q) = 0.875 
Value: 0.875 x 27°" = 1.875 


Zero: The sign bit is either 0 (positive) or 1 (negative) and indicates +0.0 and -0.0, respectively. 
The exponent and mantissa are 0. Both +0.0 and —0.0 represent 0.0. See appendix A.3.4, 
Floating-Point Operation Specifications, for differences in each operation depending on the sign. 


Infinity: The sign bit is either 0 (positive) or 1 (negative) and indicate +oo and —co respectively. 
The exponent is 2047 (2'' — 1). The mantissa is 0. 


Not a Number: The exponent is 2047 (2'' — 1) and the mantissa is not equal to 0. 


Note: When the CPU is SH3E, the not a number for the most significant bit of the mantissa 
which is 0 is called qNaN, and the not a number for the most significant bit of the 
mantissa which is | is called sNaN. Other mantissa field values and sign parts are not 
specified. 
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A.3.4 Floating-point Operation Specifications 


This section explains the floating-point arithmetic used in C language functions. It also gives the 
specifications for converting between the decimal representation and the internal representation of 
floating-point numbers generated during C comoiler or standard library function processing. 


Arithmetic Operation Specifications: 


1. Result Rounding 


If the precise result of a floating-point operation exceeds the significant digits of the internally 
represented mantissa, the result is rounded as follows: 


a. 
b. 


The result is rounded to the nearest internally representable floating-point number. 

If the result is directly between the two nearest internally representable floating-point 
numbers, the result is rounded so that the lowest bit of the mantissa becomes 0. 

When the CPU is SH3E, the number of digits that exceed the significant digit are rounded 
down. 


2. Overflow/Underflow and Invalid Operation Handling 


Invalid operations, overflows and underflows resulting from numeric operations are handled as 
follows: 


a. 
b. 
C. 


For an overflow, positive or negative infinity is used depending on the sign of the result. 
For an underflow, positive or negative zero is used depending on the sign of the result. 

An invalid operation is assumed when: 1. infinity is added to infinity and each infinity has 
a different sign, ii. infinity is subtracted from infinity and each infinity has the same sign, 
iii. Zero is multiplied by infinity, iv. zero is divided by zero, or v. infinity is divided by 
infinity. In each case, the result is not a number. 

Data accuracy cannot be guaranteed if the data overflows when converting floating-point 
data to integer data. 


Note: Operations are performed with constant expressions at compile time. If an overflow, 


underflow, or invalid operation is detected during these operations, a warning-level error 
occurs. 


3. Special Value Operations 


More about special value (zero, infinity, and not a number) operations: 


a. 


b 
C. 
d 
e 


If positive zero and negative zero are added, the result is positive zero. 

If zero is subtracted from zero and both zeros have the same sign, the result is positive zero. 
The operation result is always a not a number if one or both operands are not a numbers. 
Positive zero is equal to a negative zero for comparison operations. 


If one or both operands are not a numbers in a comparison or equivalence operation, the 
result of != 1s always true and all other results are false. 
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Conversion between Decimal Representation and Internal Representation: This 
section explains the conversion between floating-point constants in a source program and floating- 
point constants in internal representation. The conversion between decimal representation and 
internal representation of ASCII character string floating-point numbers by library functions is 
also explained. 


ls 


To convert a floating-point number from decimal representation to internal representation, the 
floating-point number in decimal representation is first converted to a floating-point number in 
normalized decimal representation. A floating-point number in normalized decimal 
representation is in the format +M x 104N. The following ranges of M and N are used: 


a. For normalized float 


O<M<10’-1 
OsNS99 
b. For normalized double and long double 
O0<Ms10"-1 
O<N < 999 


An overflow or underflow occurs if a floating-point number in decimal representation cannot be 
normalized. If a floating-point number in normalized decimal representation contains too many 
significant digits, as a result of the conversion, the lower digits are discarded. In the above 
cases, a warning-level error occurs at compilation and the variable errno is set equal to the 
corresponding error number at run time. 


To convert a floating-point number from decimal representation to normalized decimal 
representation, the length of the original ASCII character string must be less than or equal to 
511 characters. Otherwise, an error occurs at compile time and the variable errno is set equal 
to the corresponding error number at run time. 


To convert a floating-point number from internal representation to decimal representation, the 
floating-point number is first converted from internal representation to normalized decimal 
representation. The result is then converted to an ASCII character string according to a 
specified format. 
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2. Conversion between Normalized Decimal Representation and Internal Representation 


If the exponent of a floating-point number to be converted between decimal representation and 
internal representation is too large or too small, a precise result cannot be obtained. This 
section explains the range of exponents for precise conversion and the error that results from 
exceeding the range. 


a. 


Range of Exponents for Precise Conversion 

Rounding as explained in the description, Result Rounding, in appendix A.3 4, Floating- 
point Operation Specifications, is performed precisely for floating-point numbers whose 
exponents are in the following ranges: 

For float : O<M<10°-1, O<N§ 13 

For double and long double: O<M<S¥ 10-1, OS N§ 27 

An overflow or underflow will not occur if the exponent is within the proper ranges. 
Conversion and Rounding Error 

The difference between, a. the error occurring when the exponent outside the proper range is 
converted, and b. the error occurring when the value is precisely rounded, does not exceed 
the result of multiplying the least significant digit by 0.47. If an exponent outside the 
proper range is converted, an overflow or underflow may occur. In such a case, a warning- 
level error occurs at compilation and the variable errno is set to the corresponding error 
number at run time. 
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Appendix B Parameter Allocation Example 


Example 1: Register parameters are allocated to registers R4 to R7 depending on the order of 


declaration. 







R4 

R5 

R6 
R7 


int f(char,short,int, float); 






P(1 5.253540) 3 





Example 2: Parameters which could not be allocated to registers R4 to R7 are allocated to the 
stack area as shown below. If a char (unsigned) or short (unsigned) type parameter is 
allocated to a parameter area on a stack, it is extended to a 4-byte area. 







int f(int,short,long, float,char) ; R4 
R5 
R6 
R7 


£1243 4-407 574 





A Lower address 


Parameter area | Nosignextension =| 5 | 
(stack) : 


y Upper address 
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Example 3: Parameters having a type that cannot be allocated to registers from R4 to R7 are 
allocated to the stack area. 


struct s{int x,y;}a; R4 


int f(int,struct s,int); 
: R5 


f(1,a,3); 


4 Lower address 


Parameter area 
(stack) 
a.y 


y Upper address 


Example 4: If a function whose number of parameters changes is specified by prototype 
declaration, parameters which do not have a corresponding type in the declaration and the 
immediately preceding parameters are allocated to a stack. 


int f(double,int,int,...) R4 


| 


£(1.072;,374) 3 


4 Lower address 


Parameter area 1.0 
(stack) 


y Upper address 
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Example 5: If a value returned by a function exceeds four bytes, or is a structure type, a return 
value is specified just before parameter area. If structure size is not a multiple of four, an unused 
area 1s generated. 


struct s{char x.y.2:}a: 
double f ( struct s ) , Parameter area 
: (stack) 


| Return value address 
area 









f(a); 


) Lower address 








Return value 
setting area 





y Upper address 


Example 6: When the CPU is SH3E, float type parameters are allocated to FPU registers. 







int f (char, float, short,float,double); R4 FR4 





£1 240; 354 407520)? FRE 


FR7 
FR8 
FR9 
FR10 
FR11 


R6 
R7 





= 
° 


4 Lower address 


oa 
(stack) 


y Upper address 
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Appendix C Usage of Registers and Stack Area 


This section describes how to use registers and stack area by the C compiler. The user does not 
have to take care how to use this area, because registers and stack area used by a function are 
operated by the C compiler. Figure C.1 shows the usage of registers and stack arca. 


(Only for SH3E) 
RO 
R1 
R2 
MC Stack area 


ones 


riz; 
ris; 
Parameter area 


Stack area 


FRO-FR15 : For variable or temporary RO-R14 : For variable or temporary 
data storage 

FR4-FR11 : For parameter storage R4-R7 : For parameter storage 
(indicated by 777) (indicated by (77) 





Figure C.1 Usage of Registers and Stack Area 
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Appendix D Creating Termination Functions 


D.1 Creating Library onexit Function 


This section describes how to create library onexit function that defines termination routines. The 
onexit function defines a function address, which is passed as a parameter, in the termination 
routine table. If the number of defined functions exceeds the limit value (assumed to be 32 in the 
following example), or if the same function is defined twice or more, NULL is returned. 
Otherwise, value other than NULL Is returned. An example of onexit routine is shown below. 


Example: 


#include <stdlib.h> 


typedef void *onexit_t; 


int _onexit_count=0; 


onexit_t (*_onexit_buf[32]) (void) ; 
extern onexit_t onexit(onexit_t (*) (vwoid)); 


onexit_t onexit (f) 


onexit_t (*f£) (void); 


{ 
int i; 
for (i=0; i<_onexit_count ; i++) 
if( _onexit_buf [i] ==f) /* Checks if the same function */ 
return NULL; /* has been defined =], 
if( _onexit_count==32) /* Checks if the No. of i] 
/* defined functions exceed ay 
/*© Jame a 4 
return NULL; 
else{ 
_onexit_buf{ _onexit_count]=f; /*Defines the function address* / 
_onexit_count++; 
return &_onexit_buf [_onexit_count -1]; 
} 
} 


HITACHI 189 


D.2 Creating exit Function 


This section describes how to create exit function that terminates program execution. Note that 
the exit function must be created according to the user system specifications referring to the 
following example, because how to terminate a program differs depending on the user system. 


The exit function terminates C program execution based on the termination code returned as a 

parameter and then returns to the environment at program initiation. Returning to the 

environment at program initiation is achieved by the following two steps: 

1. Sets a termination code in an external variable 

2. Returns to the environment that is saved by the setjmp function immediately before calling the 
main function 


An example of the exit function is shown below. 
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#include <setjmp.h> 
#include <stddef.h> 


typedef void *onexit_t; 
extern int _onexit_count; 


extern onexit_t (*_onexit_buf[(32j) (void); 


extern jmp_buf _init_env ; 


extern int _exit_code ; 


extern void _CLOSEALL() ; 
extern void exit(int) ; 


void exit (code) 


int code ; 


{ 


_exit_code=code ; /*Sets return code to _exit_code */ 


for(int i=_onexit_count-1; i>0; i--) 


(*_onexit_buf[i]) (); /*Sequencially executes functions 
defined by onexit*/ 
_CLOSEALL () ; /*Closes all files opened*/ 
longjmp(_init_inv, 1) ; /*Returns to the environment saved 


by the setjmp*/ 
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Note: To return to the environment before program execution, create the callmain function and 
call the callmain function instead of calling the main function from the init routine as 
shown below. 


#include <setjmp.h> 
jmp_buf _init_env; 
int _exit_code; 


void callmain() 
{ 


/* Saves current environment by setjmp function and calls the */ 
/* main function ay 


/* Terminates C program if a termination code is returned from the */ 
/* exit function a | 


if(!setjmp(_init_env) ) 
_exit_code = main(); 


} 


D.3 Creating Abort Routine 


To terminate the routine abnormally, the program must be terminated by an abort routine prepared 
according to the user system specifications. The following shows an example of abort routine in 
which an error message is output to the standard output device, closes all files, enters endless loop, 
and waits for reset. 


Example: 
#include <stdio.h> 


extern void abort(); 
extern void _CLOSEALL(); 


void abort () 

{ 
printf ("program is abort !!\n"); /*Outputs message uit f 
_CLOSEALL () ; /*Closes all files i J 
while(1); /*Enters endless loop */ 
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Appendix E Examples of Low-Level Interface Routine 


[REFERER ERRKRE EERE RERE RRR RRAREERER ERK RERERREKR KKK KERERRE ER EK EREREREREEER KR ERK 


/* lowsrc.c: ee 
/* ey Sess “Siz. Tiel the me Sa a i OM Oe Og te Ret Fe Ot Oh see ott pata. ES eR et od te Oo em th em A AR i en we = ee a “rtey Stee © Nd x / 
/* SH-series simulator debugger interface routine a7 
f* - Only standard I/O files (stdin, stdout, stderr) are supported “/ 


f REESE EERE LEELA ERE LEER EERE EELS REE ERA RARER ERAN REA ERAS ER EERE ARE RR AS 


#include <string.h> 


/* file number */ 


#define STDIN 0 /* Standard input (console) a 
#define STDOUT 1 /* Standard output (console) a A 
#define STDERR 2 /* Standard error output (console) */ 
#define FLMIN 0 /* Minimum file number * / 
#define FLMAX 3 /* Maximum number of files ait 2 


/* file flag */ 


#define O_RDONLY 0x0001 /* Read only = 
#define O_WRONLY 0x0002 /* Write only */ 
#define O_RDWR 0x0004 /* Both read and write iy A 


/* special character code */ 


#define CR 0x0d /* Carriage return ay 
#define LF 0x0a /* Line feed ef 


/* size of area managed by sbrk */ 


#define HEAPSIZE 1024 


Lf REREREREEEEEKEKERRERRER EERERREREERAEEEEREEEEERAKERERERER RERKREEEEERRERRREEKEKE 


/* Declaration of reference function aay d 
/* Reference of assembly program in which the simulator debugger input or */ 
/* output characters to the console af 
[ RRERKRAEREREK KEKE KEEREEKEEEKEREEKREKEKREKEEKERERRERER EKER EEKEKEEKERERERKE KKK ERK / 
extern void charput (char) ; /* One character input oh 
extern char charget (void) ; /* One character output x]; 
[RRR KH KKK KEK KKH KK RE KKK KEKE ERE REK KEK KKEKEKEREKKE KEKE KHER EK KKK KKERKKKRKKK KKK KKK KK / 
/* Definition of static variable: a; 
/* Definition of static variables used in low-level interface routines “i 


[aR RK RK KK KKK KK KR KK KKK KR IKKE RIKER KK KEK IKK KH K KEKE KER KERR KKK KKK RIK K / 


char flmod[FLMAX] ; /* Open file mode specification area */ 

static union ({ 
long dunmy ; /* Dummy for 4-byte boundary x). 
char heap (HEAPSIZE] ; /* Declaration of the area managed aes 
/* by sbrk ae 


} heap_area ; 


static char *brk=(char *)&heap_area;/* End address of area assigned by a 4 
/* sbrk x / 
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[BERR KIRK IKKE RHR EK KEKE KEK RE RE RR ERE EKER RE REE KEKE ERK HEE EKKR EEK ERK KK KEKE REREKK KE / 


[= open: file open nf 
fae Return value: File number (Pass) * / 
ss -1 (Failure) */ 
[ REERERERERERR ERE RE RERKRARERA RENAE ERE ERE RE EREE RE REE RARER KREREEREAEA ERE ER EEKE RE / 
int open(char *name, /* File name * / 
int mode) /* File mode */ 
/* Check mode according to file name and return file numbers * / 
if (strcmp (name, "stdin")==0) { /* Standard input file aay | 
if ( (mode&O_RDONLY) ==0) 
return -l; 


flmod [STDIN] =mode; 
return STDIN; 


} 
else if (strcmp (name, "stdout")==0){ /* Standard output file */ 
if ( (mode&O_WRONLY) ==0) 
return -1; 
£1mod [STDOUT] =mode; 
return STDOUT; 
} 
else if (strcmp (name, "stderr")==0){ /* Standard error file * / 
L£ ( (mode&O_WRONLY ) ==0) 
return -1; 
f1lmod [STDERR] =mode; 
return STDERR; 
} 
else 


return -1; /* Error * / 


[BREE EE EKER EERE EERERKEKEERERKEERER EER EKERKEREREREEKEREEK ERE REREREREEKREEKKE K / 


/*  close:File close ie 
‘eid Return value:0 (Pass) ad 
ie -l (Failure) OL 
[REE AEERAARA LALA AS ERA REARS ERRA AEA RERLE ERAN SRE RAR ARRAN EERE EER EAM / 
int close(int fileno) /* File number «if 
if (fileno<FLMIN || FLMAX<fileno) /* File number range check oy 
return -1; 
flmod[{fileno]=0; /* File mode reset */ 
return 0; 
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[ERE EER ELL EELS ES MLE A NRE SRR SE RNR A ER NN AL AR Ne OR A ae a7, 


/* read:Data read 7, 
[* Return value:Number of read characters (Pass) ay 
ls -1 (Failure) */ 
[LPRERREERAR ERE REEL REEL ES SEAMEN RAR RAERRAE EE RRR EE REA EARR LENE LEAR ERAT 
int read(int fileno, /* File number * / 

char *buf, /* Destination buffer address */ 

unsigned int count) /* Number of read characters */ 
{ 


unsigned int i; 
/*Check mode according to file name and store each character in buffer */ 
if (flmod[fileno]&O_RDONLY | | flmod[fileno] &O_RDWR) { 


for(i=count; i>0; i--) { 
*buf=charget () ; 


if (*buf==CR) /*Line feed character replacement*/ 
*buf=LF; 
buf++; 
} 
return count; 
} 
else 
return -1; 
} 
[RK KKK HK KKK ERE KERR ERE KEK RERRERERERERREREKKEKRERERKRERRERKKARK KKK KKK / 
/* write:Data write */ 
[* Return value:Number of write characters (Pass) am 4 
Yes -1 (Failure) */ 
LER ERELLARAE ARES REREA EAA EER RERRERER RARE RRRRER EE ERAELARER WARE RAR AER EER REE KER / 
int write(int fileno, /* File number */ 
char *buf, /* Destination buffer address */ 
unsigned int count) /* Number of write characters */ 
{ 
unsigned int if; 
char c; 
/* Check mode according to file name and output each character a 
if (f£lmod[fileno] &O_WRONLY || flmod[fileno] &O_RDWwR) { 
for(i=count; i>0; i--){ 
c=*buf++; 
charput (c) ; 
} 
return count; 
} 
else 
return -1; 
} 
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f EREEEEAR EERO REALE EL EERE EERE EER EA RRR ERA EEA REA ENS EAR ARAN SAR EM RRR ASS 


/* lseek:Definition of file read/write position #7 
f® Return value:Offset from the top of file read/write position(Pass) */ 
[= -1 (Failure) x} 
i* (lseek is not supported in the console input/output) a 
[ RAEREEREEAEARE ER ERER RAE ERE ER EKER ERE ERR EARAR EARE EERE EER EE ROSE} 
long lseek(int fileno, /* File number */ 
| long offset, /* Read/write position */ 
int base) /* Origin of offset */ 

{ 

return -1; 
} 


[EERE ESERAEEEREEEREAER ALES EES RELERRRAREAREERARER EAE RRERREREAR ERR AA RARE ER HK / 


ce sbrk:Data write af 
ys Return value:Start address of the assigned area (Pass) 7. 
[= ~1 (Failure) ae | 
[ ERRREREREAREEE EEK ERK ER EERERERERERERAREERREREREREEREERRERERER ERE EERERAERERE © / 
char *sbrk(unsigned long size) /* Assigned area size */ 
{ 

char *p ; 

if (brk+size>heap_area.heap+HEAPSIZE) /* Empty area size a | 

return (char *)-1 ; 
p=brk ; /* Area assignment ai 
brk += size ; /* End address update = 


return p ; 
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A_DATA: 
A_PARM: 
A_FNO: . 
F.pute: 
F_getc: 
N_IO: 


SH SERIES SIMULATOR DEBUGGER INTERFACE ROUTINE 
Input/output one character- 


. EXPORT 
. EXPORT 


. EQU 


. SECTION 


_charput: 


MOV. 
MOV. 
MOV. 
MOV. 
MOV. 
MOV. 
MOV. 
MOV. 
MOV. 
JSR 
NOP 
RTS 
NOP 


Crowder prp Or 


~ ~ = _ —_—_— _ ~ _ _ 


_charput 
_charget 

H' 0080 

P, CODE, ALIGN=4 


One character output 


A_DATA, RO 
R4, @RO 
A_PARM, Rl 
RO, @(4,R1) 
A_FNO, RO 
@RO, RO 
RO, @(1, 
Fo putc, 
N_IO, R2 
@R2 


R1) 
RO 


_charget: One character input 


Co er 


A_PARM, R1 
A_DATA, RO 
RO, @(4,R1) 
A_FNO, RO 
@RO, RO 

RO, @(1, R1) 
F_getc, RO 
N_IO, R2 
@R2 

A_PARAM, Rl 
@(4,R1), RO 
@RO, RO 

4 

DATA 

PARM 

FILENO 
H‘01280000 
H‘01270000 
SIM_IO 


. 
UJ 


;Specifies 


;Specifies 


r3 
ye) 
=) 
ti 
ay) 
O 
'S) 
AJ 
tJ 
U 

U 


Specifies data 


;Specifies parameter block address 
;Specifies data buffer start address 
file number 


function code 


;Specifies parameter block address 
;Specifies data buffer start address 


;Specifies file number 


:;Specifies function code 


;References data 


;Data buffer start address 
;Parameter block address 
;File number area address 
;fputc function number 
;fgetc function number 
;Trap address 
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. SECTION B, DATA, ALIGN=4 
PARM: ».RES.L 2 ; Parameter block area 
FILENO: .RES.B a3 ; File number area 
DATA: .RES.B a ; Data assign area 
. END 
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Appendix F ASCII Codes 


PARITY BIT] bt | | | EP 
v7 | aes es ee 


F S1 S7 / ? RUB 
OUT 


Notes: Vv : Yes 
—:No 
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COmpilatiOn SPEC ICAL ONS vessel seas setessasesad eset tetae Alea hsa ies at eest an toes eee teete taken te titeats 159 
CONS Ua Ha pe teaches testaisin Sa desst au tieaenanlaitins bea caida apiotatiae daa ine ctua veered doa wepaneaeal lena sieal lauded Boel adele cemetdoueuees 89 
CONSE (SUDO DULOM ) aa esoa toes sei case deena pane cesna iamsun cas ovseroranensnwsnsose magia doers meha ceabenaibuacnsuceawsnieaeans 11,15,16 
GONSTANE AlAs ic suns seins6s cach asanacnapegusauted aauauastad assy iacesousstaiauseaencseeieaacsanes Bote oh eees ccaesieeahyeeotaniieeree: 39 
Correspondence 1o-standard: OLames :ncefeice ss at eneesieene si eitachs A a hast tha rec paneueei he ideas 21 
CDN CO BOI) acicce cesta eeeteatusnetetat ar cnvse a cGuacee trie season er alenetaactoeaem a teeenass a eaieae dane eee 10,13 


HITACHI 201 


CU (SUDO PUN) esas cusenzss cedecistnmscneng sanders acer toeuesbescus saauareantesat ouuhnedocenciiettsenagsaueesesaveien everest asgdanives 12,17 


Creating library Onexit PUNCHION ct cessncieenitiwsesay a uedarsataste eactaay sah eee aa G 189 
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Inline expansion in assembly language ...........c.cceccesscssscssscceseesecsceeccsscssnceescesseseeeeeeesscesenseeeseesenees 79 
DEG eeepc itt ee peddle cat ete Pees ace sehenaea easeneneeusnereeacoiue eae mentuete meno tencags 42,48 
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